【Shopify最新ニュース2026・開発者向け】Gift Card の line_item_id が 2027-01 で読み取り専用に

2026年11月3日

開発者向けの変更です。

REST Admin API の 2027-01 から、line_item_id は読み取り専用になります

対象は、Gift Card リソースの line_item_id。

掲載は2026年10月30日、開発者向けの Changelog。

出典: Shopify developer changelog「Gift Card line_item_id will become read-only in REST Admin API version 2027-01」2026年10月30日
https://shopify.dev/changelog/rest-gift-card-line_item_id-will-become-read-only-in-api-version-2027-01

Version: 2027-01
Flags: Breaking API Change／Action required
Surfaces: API
Affected APIs: Admin REST API

In REST Admin API version 2027-01 and later, the line_item_id property on the Gift Card resource is read-only. Shopify ignores the property in create and update requests. Remove it from those requests before you upgrade.
（REST Admin API のバージョン 2027-01 以降、Gift Card リソースの line_item_id プロパティは読み取り専用になります。作成と更新のリクエストでは、Shopify はこのプロパティを無視します。アップグレードの前に、これらのリクエストから外してください）

作成と更新で、明細との紐付けを変えられなくなります

アプリからできなくなる操作は、追加・置き換え・解除の3つ。

In REST Admin API version 2027-01 and later, apps can’t add, replace, or clear a gift card’s line-item association through Gift Card create or update requests. Shopify ignores any line_item_id value in those requests.
（REST Admin API の 2027-01 以降、アプリは Gift Card の作成・更新リクエストで、ギフトカードと注文明細の紐付けを追加・置き換え・解除できません。これらのリクエストに入った line_item_id の値は、Shopify が無視します）

リクエストそのものは受け付けられます。

In REST Admin API version 2027-01 and later, Shopify accepts create and update requests that include line_item_id and ignores the property. The gift card keeps its existing line-item association.
（REST Admin API の 2027-01 以降、Shopify は line_item_id を含む作成・更新リクエストを受け付け、そのプロパティを無視します。ギフトカードは既存の明細との紐付けを保ちます）

代わりの API は無し。

There isn’t a replacement API for adding, replacing, or clearing a gift card’s line-item association from outside Shopify.
（Shopify の外からギフトカードと明細の紐付けを追加・置き換え・解除するための、代わりの API はありません）

読み取りと、古いバージョンの動きは変わりません

レスポンスには、今ある紐付けが入ったまま。

Gift Card responses still include existing line-item and order associations. Earlier API versions keep their current behavior.
（Gift Card のレスポンスには、既存の明細と注文の紐付けが引き続き含まれます。それより前の API バージョンは今の動きのままです）

紐付けの意味も、原文は説明しています。

A gift card’s line-item association records the order line item that created the gift card.
（ギフトカードの明細との紐付けは、そのギフトカードを生んだ注文明細を記録するものです）

影響を受けるのは、3つの条件が全部そろうアプリです

当てはまるかは、次の3点で決まります。

Your app uses the REST Admin API Gift Card resource.
Your app includes line_item_id when it creates or updates gift cards.
You plan to upgrade your app to API version 2027-01 or later.
（アプリが REST Admin API の Gift Card リソースを使っている／ギフトカードの作成・更新で line_item_id を送っている／2027-01 以降へのアップグレードを予定している）

読むだけのアプリと、2027-01 より前に留まるアプリは対象外。

If your app only reads line_item_id from Gift Card responses, or stays on an API version earlier than 2027-01, then this change doesn’t affect you.
（Gift Card のレスポンスから line_item_id を読むだけのアプリや、2027-01 より前の API バージョンに留まるアプリは、この変更の影響を受けません）

移行は、送信をやめて読み取りで確かめる手順です

公式の手順は、探す・外す・読み続けるの3段。

line_item_id を送っている REST の Gift Card の作成・更新の呼び出しを探す
そのリクエストの中身から line_item_id を外す
今の紐付けが要るなら、Gift Card のレスポンスから line_item_id を読み続ける

確認の手順は2つ。

line_item_id を入れずに、作成か更新のリクエストを送る
同じギフトカードを読み、line_item_id の値が変わっていないことを見る

送り続けたときの行方も、原文に書いてあります。

Before you move production traffic to REST Admin API version 2027-01 or later, stop sending line_item_id in Gift Card create and update requests. Otherwise, your app’s records might not match Shopify’s, because Shopify keeps the original association.
（本番の通信を REST Admin API の 2027-01 以降へ移す前に、Gift Card の作成・更新リクエストで line_item_id を送るのをやめてください。そうしないと、Shopify は元の紐付けを保つため、アプリの記録と Shopify の記録が食い違うおそれがあります）