Gift Card 的 line_item_id 在 REST Admin API 2027-01 版本中将变为只读

在 REST Admin API 2027-01 及更高版本中，礼品卡资源的 line_item_id 属性为只读。Shopify 会忽略创建和更新请求中的该属性。请在升级前从这些请求中移除它。

变更内容

在 REST Admin API 2027-01 及更高版本中，应用无法通过礼品卡的创建或更新请求添加、替换或清除礼品卡的行项目关联。Shopify 会忽略这些请求中的任何 line_item_id 值。

礼品卡响应仍包含现有的行项目和订单关联。早期 API 版本保持其当前行为。

受影响对象

如果满足以下所有条件，则此变更会影响您：

• 您的应用使用 REST Admin API Gift Card 资源。
• 您的应用在创建或更新礼品卡时包含 line_item_id。
• 您计划将应用升级到 API version 2027-01 或更高版本。

如果您的应用仅从礼品卡响应中读取 line_item_id，或者仍使用早于 2027-01 的 API 版本，则此更改不会影响您。

为何重要

礼品卡的行项目关联记录了创建该礼品卡的订单行项目。将 line_item_id 设为只读可阻止应用更改礼品卡与其订单之间的链接。

破坏性变更与迁移

在 REST Admin API 2027-01 及更高版本中，Shopify 接受包含 line_item_id 的创建和更新请求并忽略该属性。礼品卡将保留其现有的行项目关联。

在升级到 API version 2027-01 之前：

1. 查找发送 line_item_id 的 REST 礼品卡创建和更新调用。
2. 从这些请求负载中移除 line_item_id。
3. 如果您的应用需要现有关联，请继续从礼品卡响应中读取 line_item_id。

没有用于从 Shopify 外部添加、替换或清除礼品卡行项目关联的替代 API。

为确认迁移：

1. 发送不包含 line_item_id 的创建或更新请求。
2. 读取同一张礼品卡，并检查其 line_item_id 值是否未发生变化。

需要采取的操作

在将生产流量迁移到 REST Admin API 2027-01 或更高版本之前，停止在礼品卡创建和更新请求中发送 line_item_id。否则，由于 Shopify 会保留原始关联，您的应用记录可能与 Shopify 的记录不一致。

相关文档

• REST Admin API Gift Card resource for 2027-01
• Shopify API versioning