创建免费送货代码折扣-discountCodeFreeShippingCreate mutation

创建免费送货代码折扣。

所需的访问

应用程序必须具有write_discounts访问范围。

在本页面

互动范例

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

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

mutation discountCodeFreeShippingCreate($freeShippingCodeDiscount: DiscountCodeFreeShippingInput!) { discountCodeFreeShippingCreate(freeShippingCodeDiscount: $freeShippingCodeDiscount) { 
  1. <font style="color:#1F61A0;">codeDiscountNode</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;">code</font>
  11.   <font style="color:#1F61A0;">extraInfo</font>
  13.   <font style="color:#1F61A0;">field</font>
  15.   <font style="color:#1F61A0;">message</font>
  17. <font style="color:#555555;">}</font>
} } { “freeShippingCodeDiscount”: {} }

争论

争论 描述
freeShippingCodeDiscount
（） [DiscountCodeFreeShippingInput!](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/discountcodefreeshippinginput)

必需的		 用于创建代码折扣的输入数据。

DiscountCodeFreeShippingInput字段

  • applyOnOneTimePurchase（[Boolean](https://shopify.dev/docs/admin-api/graphql/reference/scalar#boolean-2021-01)）
    折扣是否适用于常规的一次性购买商品。
  • applyOnSubscription（[Boolean](https://shopify.dev/docs/admin-api/graphql/reference/scalar#boolean-2021-01)）
    折扣是否适用于订购项目。
  • applyOncePerCustomer（[Boolean](https://shopify.dev/docs/admin-api/graphql/reference/scalar#boolean-2021-01)）
    每个客户是否只能享受一次折扣。
  • 代码（[String](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01)）
    使用折扣的代码。
  • customerSelection（[DiscountCustomerSelectionInput](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/discountcustomerselectioninput)）
    可以使用折扣的客户。
  • 目的地（[DiscountShippingDestinationSelectionInput](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/discountshippingdestinationselectioninput)）
    可以享受折扣的目的地列表。
  • endsAt（[DateTime](https://shopify.dev/docs/admin-api/graphql/reference/scalar#datetime-2021-01)）
    折扣结束的日期和时间。对于开放式折扣，请使用null。
  • maximumShippingPrice（[Decimal](https://shopify.dev/docs/admin-api/graphql/reference/scalar#decimal-2021-01)）
    有资格享受折扣的最高运费。
  • minimumRequirement（[DiscountMinimumRequirementInput](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/discountminimumrequirementinput)）
    要应用折扣所需的最小小计或数量。
  • recurringCycleLimit（[Int](https://shopify.dev/docs/admin-api/graphql/reference/scalar#int-2021-01)）
    折扣适用于重复购买（订购）的次数。
  • startsAt（[DateTime](https://shopify.dev/docs/admin-api/graphql/reference/scalar#datetime-2021-01)）
    折扣开始的日期和时间。
  • 标题（[String](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01)）
    折扣的标题。
  • usageLimit（[Int](https://shopify.dev/docs/admin-api/graphql/reference/scalar#int-2021-01)）
    可以使用折扣的最大次数。对于开放式折扣，请使用null。

返回字段

  • codeDiscountNode（[DiscountCodeNode](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/discountcodenode)）
    创建的代码折扣。
  • userErrors（[[DiscountUserError!]!](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/discountusererror)）
    执行突变时发生的错误列表。