客户更新 突变

更新客户的属性。

所需的访问

write_customers 访问范围。

在本页面

互动范例

这是一个示例变异查询。使用下面的嵌入式交互式工具来编辑查询。

提示：使用Ctrl+Space表示自动填充字段。

变异customerUpdate （$ input ：CustomerInput ！）{ customerUpdate （输入：$ input ）{ 
  1. <font style="color:#1F61A0;">客户</font><font style="color:#555555;">{</font> 
  3.   <font style="color:#1F61A0;">ID</font>
  5. <font style="color:#555555;">}</font>
  7. <font style="color:#1F61A0;">userErrors </font><font style="color:#555555;">{</font> 
  9.   <font style="color:#1F61A0;">场地</font>
  11.   <font style="color:#1F61A0;">信息</font>
  13. <font style="color:#555555;">}</font>
} } { “输入” ：{} }

争论

争论 描述
input
（） [CustomerInput!](https://shopify.dev/docs/admin-api/graphql/reference/customers/customerinput)

必需的		 为客户提供更新的字段。

CustomerInput字段

  • acceptsMarketing（[Boolean](https://shopify.dev/docs/admin-api/graphql/reference/scalar#boolean-2021-01)）
    客户是否同意通过电子邮件接收营销材料。
  • acceptsMarketingUpdatedAt（[DateTime](https://shopify.dev/docs/admin-api/graphql/reference/scalar#datetime-2021-01)）
    客户同意或反对通过电子邮件接收营销材料的日期和时间。在客户同意或反对营销材料时设置。
  • 地址（[[MailingAddressInput!]](https://shopify.dev/docs/admin-api/graphql/reference/common-objects/mailingaddressinput)）
    指定客户地址的输入。
  • 电子邮件（[String](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01)）
    客户的唯一电子邮件地址。
  • 名字（[String](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01)）
    客户的名字。
  • 编号（[ID](https://shopify.dev/docs/admin-api/graphql/reference/scalar#id-2021-01)）
    指定要更新的客户，如果不存在，则创建一个新客户。
  • 姓氏（[String](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01)）
    客户的姓氏。
  • 语言环境（[String](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01)）
    客户的语言环境。
  • marketingOptInLevel（[CustomerMarketingOptInLevel](https://shopify.dev/docs/admin-api/graphql/reference/customers/customermarketingoptinlevel)）
    客户同意通过电子邮件接收营销材料时启用的市场营销订阅选择级别（如M3AAWG最佳实践指南所述）。
  • 元字段（[[MetafieldInput!]](https://shopify.dev/docs/admin-api/graphql/reference/metafields/metafieldinput)）
    将其他元数据附加到客户。
  • 注意（[String](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01)）
    关于客户的说明。
  • 电话（[String](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01)）
    客户的唯一电话号码。
  • privateMetafields（[[PrivateMetafieldInput!]](https://shopify.dev/docs/admin-api/graphql/reference/metafields/privatemetafieldinput)）
    与该产品关联的私有元字段。
  • 标签（[[String!]](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01)）
    以逗号分隔的与客户相关联的标签列表。更新将tags覆盖以前添加到客户的所有现有标签。要添加新标签而不覆盖现有标签，请使用tagsAdd 突变。
  • taxExempt（[Boolean](https://shopify.dev/docs/admin-api/graphql/reference/scalar#boolean-2021-01)）
    客户是否可以免交订单税。
  • taxExemptions（[[TaxExemption!]](https://shopify.dev/docs/admin-api/graphql/reference/customers/taxexemption)）
    适用于客户的免税清单。

返回字段

  • 客户（[Customer](https://shopify.dev/docs/admin-api/graphql/reference/customers/customer)）
    更新的客户。
  • userErrors（[[UserError!]!](https://shopify.dev/docs/admin-api/graphql/reference/usererror)）
    执行突变时发生的错误列表。