商家经常为同一商品变体使用多个标识符进行销售:例如制造商 UPC 与自有品牌 EAN、GTIN、重新发行的 ISBN,或市场列表的 ASIN。在此之前,一个变体仅持有一个条形码值,因此额外的标识符最终被存储在元字段(metafields)、标签中,或者完全在 Shopify 之外。
更新内容
您现在可以通过 ProductVariant 上的新 barcodes 连接读取变体的完整条形码集合,并通过 productSet mutation 中的 barcodes 输入参数写入数据。 您可以通过 ProductVariant 上的新条形码连接读取变体的完整集合,并通过 productSet 突变、productVariantsBulkCreate 突变和 productVariantsBulkUpdate 突变上的 barcodes 输入写入它。, productVariantsBulkCreate mutation,以及 productVariantsBulkUpdate mutation。
每个条形码都可以声明其类型:UPC、EAN、ISBN、GTIN 或 ASIN。我们会根据该标准的字符、长度、前缀和校验位规则对值进行验证。如果您未声明类型,我们将原样存储您发送的值,以便未指定类型的旧数据能继续正常工作。
使用指南
- 一个变体最多可接受 20 个条形码,每个条形码最长 255 个字符。
- 您发送的第一个条形码是现有 barcode 字段返回的值,并且在 barcodes 连接中排序第一。 barcodes 连接。
- 单个变体输入不能同时设置 barcode 和 barcodes。
- 发送 barcodes 会替换变体的整个集合,因此请包含您希望保留的条形码。
- 在 barcode products 和 productVariants 查询中的条形码过滤器现在匹配变体上的任何条形码。
- 发送带有 type 类型的条形码将根据该标准的规则进行验证。如果您未声明类型,我们将按原样存储您发送的值。
与 ProductVariant.barcode
ProductVariant.barcode 现已弃用,但今天没有任何功能中断,并且 barcode 继续正常工作:
- 读取 barcode 返回 barcodes 连接中的第一个条目。
- 写入 barcode 更新 barcodes 连接中的第一个条形码,并保留变体的其他条形码不变。 barcodes 连接并保留变体的其他条形码不变。发送空值会清除第一个条形码,并用集合中的下一个条形码替换它,直到没有剩余的条形码为止。
- 单个变体输入无法同时设置 barcode 和 barcodes。
在连接中第一个位置添加或更改条形码,可以让您在尚未迁移的表面上保持控制,同时获得完整的多条形码体验。
注意潜在的静默截断
一旦向变体添加了第二个条形码,仅读取 barcode 的集成将看到其中一个条形码,且没有任何信号表明还有其他条形码存在。如果您的应用将产品标识符同步到 ERP、市场、POS 或供应商馈送,请将这些读取操作移至 barcodes 连接。
我们将在未来的帖子中宣布移除日期,并在该字段消失前提供完整的 API 版本通知。
要开始使用,请参阅 ProductVariant、 ProductVariantBarcode、 BarcodeInput和 BarcodeType。

