InventoryItem.variant 字段已被弃用,并将在未来的 API 版本中移除。请改用新的 InventoryItem.variants 连接。
如需了解更多,请参阅 GraphQL Admin API 参考文档中的 InventoryItem 对象 或 inventoryItem 查询。
我们进行此项变更的原因
新的 variants 连接允许通过分页连接检索 ProductVariants,而不是单个变体对象。此更新旨在为未来支持多个变体共享单个库存项做好准备。
最初,variants 连接将返回单个节点。然而,我们建议更新您的集成以将 variants 作为连接来处理,以适应未来的变更。
您需要执行的操作
通过用 variants 替换 variant 来修改您的 GraphQL 查询。由于 variants 是一个连接,请确保请求 edges 和 nodes。尽管已弃用的 variant 字段在所有支持的 API 版本(包括 2026-01)中仍功能正常,但它最终将被移除。现在更新您的查询可确保它们与未来的 API 版本保持兼容。
变更前(已弃用):
{ inventoryItem(id: "gid://shopify/InventoryItem/123") { variant { id sku } } }变更后(推荐):
{ inventoryItem(id: "gid://shopify/InventoryItem/123") { variants(first: 10) { edges { node { id sku } } } } }
