2026年7月，DraftOrderLineItem.grams 字段被移除

变更内容

自2026-07版本起，我们将从管理端GraphQL API的DraftOrderLineItem对象中移除grams字段，该字段早在8年多前就已弃用。在2026-04 API版本不再受支持后，任何引用DraftOrderLineItem.grams的查询都将返回错误。

您需要执行的操作

请将所有对grams的使用替换为DraftOrderLineItem上的weight字段，该字段同时返回值和单位，比旧的整数型grams字段更具灵活性。

之前（已弃用）：

query { draftOrder(id: "gid://shopify/DraftOrder/1") { lineItems(first: 5) { nodes { grams } } } }

之后：

query { draftOrder(id: "gid://shopify/DraftOrder/1") { lineItems(first: 5) { nodes { weight { value unit } } } } }

我们做出此变更的原因

grams 字段仅支持单一单位，且对于较大重量时可能发生溢出。weight 字段使用包含 value 和 unit 的 WeightInput，更加灵活，并与平台中其他地方的重量处理方式保持一致。

需要帮助？

如需更多详情，请参阅DraftOrderLineItem参考文档。若您对此变更有任何疑问，请通过Shopify Partners 社区与我们联系。