商品变体

重要的

应用程式无法再使用inventory_quantity或设定广告空间inventory_quantity_adjustment。有关更多信息，请参阅更新库存。

可以将变体添加到“商品”资源中，以表示具有多个选项的商品的一个版本。商品资源的选项的每种可能组合都有一个变体。每个商品最多可以有三个选项和最多100个变体。

商品变体可以做什么

Shopify API使您可以使用商品变体资源执行以下操作。这些常规操作的更详细的版本可能可用：

商品变体属性

条码	`plain "barcode": "1234_pink"` 商品的条形码，UPC或ISBN号。
compare_at_price	`plain "compare_at_price": "299.00"` 调整或出售前的项目原始价格。
created_at	`plain "created_at": "2012-08-24T14:01:47-04:00"` 创建商品变型的日期和时间（ISO 8601格式）。
履行服务	`plain "fulfillment_service": "manual"` 与商品变型相关联的履行服务。有效值：`manual`或履行服务的句柄。
克	`plain "grams": 567` 商品变体的重量（克）。
ID	`plain "id": 808950810` 商品变体的唯一数字标识符。
image_id	`plain "image_id": 434522` 商品图像的唯一数字标识符。该图像必须与该变体关联到同一商品。
stock_item_id	`plain "inventory_item_id": 342916` 库存物品的唯一标识符，在库存API中用于查询库存信息。
库存管理	`plain "inventory_management": "shopify"` 履行服务，用于跟踪商品变式的库存物品数量。有效值： + `shopify`：您正在使用管理员自己跟踪库存。 + `null`：您不会跟踪该变体的库存。 + 已启用库存管理的履行服务的句柄：这必须与`fulfillment_service`属性引用的履行服务相同。
库存政策	`plain "inventory_policy": "continue"` 缺货时是否允许客户订购商品变体。有效值： + `deny`：如果商品缺货，则不允许客户下订单。 + `continue`：如果商品缺货，则允许客户下订单。默认值：`deny` 。
库存数量只读	`plain "inventory_quantity": 10` 所有地点的库存汇总。要在特定位置调整库存，请使用 InventoryLevel资源。
old_inventory_quantity 不推荐使用	`plain "old_inventory_quantity": 5` 不推荐使用此属性。请改用 InventoryLevel资源。
库存数量调整不推荐使用	`plain "inventory_quantity_adjustment": 5` 不推荐使用此属性。请改用 InventoryLevel资源。
选项	`plain "option1": "Pink"` 商店所有者用于定义商品变型的自定义属性。您可以定义一个商品变型三种选择：`option1`，`option2`，`option3`。默认值：`Default Title`。该`title`场是的串联`option1`，`option2`和 `option3`领域。更新`option`字段将更新该`title`字段。
presentment_prices 只读	plain "presentment_prices": [ { "price": { "currency_code": "USD", "amount": "199.99" }, "compare_at_price": { "currency_code": "USD", "amount": "249.99" } }, { "price": { "currency_code": "EUR", "amount": "158.95" }, "compare_at_price": { "currency_code": "EUR", "amount": "198.95" } }, { "price": { "currency_code": "GBP", "amount": "143.00" }, "compare_at_price": { "currency_code": "GBP", "amount": "179.00" } }, { "price": { "currency_code": "JPY", "amount": "22400" }, "compare_at_price": { "currency_code": "JPY", "amount": "28000" } } ] 商店支持的每种展示货币的变体的展示价格和比较价格的列表。每个价格对象具有以下属性： + `currency_code`：商店的已启用演示货币之一的三字母代码（ISO 4217格式）。 + `amount`：变体的价格或比较货币（以演示货币表示）。需要标题`'X-Shopify-Api-Features': 'include-presentment-prices'` 。
位置只读	`plain "position": 1` 商品变体列表中商品变体的顺序。列表中的第一个位置是`1`。变体的位置由其列出的顺序指示。
价格	`plain "price": "199.00"` 商品变体的价格。
product_id	`plain "product_id": 632910392` 商品的唯一数字标识符。
require_shipping 不推荐使用	`plain "requires_shipping": true` 不推荐使用此属性。请改用InventoryItem资源上的`requires_shipping`属性。
ku	`plain "sku": "IPOD2008PINK"` 商店中商品变体的唯一标识符。为了连接到FulfillmentService是必需的。
应课税	`plain "taxable": true` 出售商品变体时是否要征税。
税法	`plain "tax_code": "DA040000"` 此参数仅适用于已安装Avalara AvaTax应用程序的商店。指定商品变式的Avalara税代码。
标题只读	`plain "title": "Pink"` 商品变体的标题。该`title`场是的串联`option1`，`option2`和`option3`领域。您只能`title`使用这些`option`字段进行间接更新。
Updated_at	`plain "updated_at": "2012-08-24T14:01:47-04:00"` 上次修改商品变体的日期和时间。以ISO 8601格式返回。
重量	`plain "weight": 100` 商品变型的重量，以单位指定`weight_unit`。
重量单位	`plain "weight_unit": "oz"` 适用于商品型号重量的度量单位。如果您未指定的值`weight_unit`，则将应用商店的默认计量单位。有效值：`g`，`kg`，`oz`，和`lb`。

终点

得到/admin/api/2021-01/products/{product_id}/variants.json 检索商品变型列表。注意：从2019-10版本开始，此端点通过使用响应标头中提供的链接来实现分页。发送<font style="background-color:#F4F6F8;">page</font>参数将返回错误。要了解更多信息，请参阅向分页的REST Admin API端点发出请求。

限制	每页最多返回这么多结果（默认值：`50` 最大：`250` ）
present_currencies	仅以某些货币返回展示价格，这些货币由逗号分隔的ISO 4217货币代码列表指定。
since_id	将结果限制为指定的ID之后
领域	以逗号分隔的字段列表，以包含在响应中

检索商品的所有变体

GET /admin/api/2021-01/products/632910392/variants.json

查看回应

指定ID后检索商品的所有变体

GET /admin/api/2021-01/products/632910392/variants.json?since_id=49148385

查看回应

以指定的展示货币检索商品的所有变体

GET /admin/api/2021-01/products/632910392/variants.json?presentment_currencies=USD,CAD

查看回应

得到/admin/api/2021-01/products/{product_id}/variants/count.json 检索多种商品变型

检索计数商品的所有变体

GET /admin/api/2021-01/products/632910392/variants/count.json

查看回应

得到/admin/api/2021-01/variants/{variant_id}.json 通过ID检索单个商品变体

领域	以逗号分隔的字段列表，以包含在响应中

通过ID检索商品变体

GET /admin/api/2021-01/variants/808950810.json

查看回应

邮政/admin/api/2021-01/products/{product_id}/variants.json 创建一个新的商品变体

创建新的商品变体

POST /admin/api/2021-01/products/632910392/variants.json

{

“变体” ： {

“ option1” ：“黄色”，
“价格” ：“ 1.00”

}

查看回应

使用元字段创建新的商品变型

POST /admin/api/2021-01/products/632910392/variants.json

{

“变体” ： {

“ option1” ：“蓝色”，
“ metafields” ： [
  {
    “ key” ：“ new”，
    “ value” ：“ newvalue”，
    “ value_type” ：“字符串”，
    “ namespace” ：“ global”
  }
]

}

查看回应

创建带有图像的新商品变体

POST /admin/api/2021-01/products/632910392/variants.json

{

“变体” ： {

“ image_id” ：850703190，
“ option1” ：“紫色”

}

查看回应

放/admin/api/2021-01/variants/{variant_id}.json 更新现有商品变体

将现有图像添加到现有变体

PUT /admin/api/2021-01/variants/808950810.json

{

“变体” ： {

“ id” ：808950810，
“ image_id” ：562641783

}

查看回应

更新现有变体的标题和价格

PUT /admin/api/2021-01/variants/808950810.json

{

“变体” ： {

“ id” ：808950810，
“ option1” ：“非粉红色”，
“价格” ：“ 99.00”

}

查看回应

将元字段添加到现有变体

PUT /admin/api/2021-01/variants/808950810.json

{

“变体” ： {

“ id” ：808950810，
“ metafields” ： [
  {
    “ key” ：“ new”，
    “ value” ：“ newvalue”，
    “ value_type” ：“字符串”，
    “ namespace” ：“ global”
  }
]

}

查看回应

删除/admin/api/2021-01/products/{product_id}/variants/{variant_id}.json

删除商品变体

删除/admin/api/2021-01/products/632910392/variants/808950810.json

查看回应