【Shopify最新ニュース2026・開発者向け】自動割引を読む automaticDiscounts が API 2027-01 で削除

2026年10月4日

開発者向けの変更です。

自動割引を読むクエリが、API 2027-01 で消えます

非推奨だった automaticDiscounts が、GraphQL Admin API から削除されます。

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

出典: Shopify developer changelog「The automaticDiscounts query is removed in API version 2027-01」2026年9月18日
https://shopify.dev/changelog/automaticdiscounts-query-is-removed-in-api-version-2027-01

Version: 2027-01
Flags: Breaking API Change / Action required
Surfaces: API
Affected APIs: Admin GraphQL API

The deprecated automaticDiscounts query is removed from the GraphQL Admin API in version 2027-01. If your app reads a shop’s automatic discounts through automaticDiscounts, you need to move to the discountNodes query with a method:automatic filter before you upgrade to 2027-01. Apps on 2026-10 and earlier keep working unchanged while those versions are supported.
（非推奨の automaticDiscounts クエリは、GraphQL Admin API のバージョン 2027-01 で削除されます。アプリが automaticDiscounts でショップの自動割引を読んでいる場合は、2027-01 に上げる前に、method:automatic の絞り込みを付けた discountNodes クエリへ移る必要があります。2026-10 以前のバージョンのアプリは、それらのバージョンがサポートされている間は変わらず動きます）

期限は、2027-01 に上げる前。

移行先は discountNodes です

query: "method:automatic" を付けて呼ぶ形。

Use discountNodes instead, with query: “method:automatic”. It returns a connection of DiscountNode objects, each exposing the discount itself on the discount field. discountNodes accepts filters similar to the removed query, including status, discount_type, discount_class, created_at, and starts_at.
（代わりに discountNodes を query: “method:automatic” 付きで使います。返るのは DiscountNode オブジェクトのコネクションで、各オブジェクトは discount フィールドに割引そのものを持ちます。discountNodes は、削除されるクエリと同様の絞り込みを受け付けます。status、discount_type、discount_class、created_at、starts_at などです）

返るのは DiscountNode のコネクション
割引の中身は、各 DiscountNode の discount フィールドに入る
使える絞り込み: status・discount_type・discount_class・created_at・starts_at
コード割引と自動割引を、1つのクエリで読める

You can call discountNodes to read both code-based and automatic discounts through one query, with a single filter vocabulary.
（discountNodes を呼べば、コードで使う割引と自動割引の両方を、1つのクエリと1つの絞り込みの語彙で読めます）

automaticDiscountNodes へ移ると、移行がもう一度要ります

automaticDiscountNodes も非推奨です。

The automaticDiscountNodes query is also deprecated in favor of discountNodes. If you migrate to automaticDiscountNodes, you’ll need to migrate again later when that query is removed.
（automaticDiscountNodes クエリも、discountNodes を使う前提で非推奨になっています。automaticDiscountNodes へ移ると、そのクエリが削除されるときに、もう一度移行が必要になります）

移る先は discountNodes
いま automaticDiscountNodes を使うアプリは、今回の削除の対象外
ただし、そのアプリも discountNodes へ移る計画が要る

Apps that use automaticDiscountNodes aren’t affected by this specific removal, but should plan to move to discountNodes.
（automaticDiscountNodes を使うアプリは今回の削除の影響を受けませんが、discountNodes へ移る計画を立てるべきです）

型も2つ消えます

消えるのは DiscountAutomaticConnection と DiscountAutomaticEdge。

As of API version 2027-01, automaticDiscounts no longer exists on QueryRoot. Requests that include automaticDiscounts on 2027-01 return a validation error instead of data. The DiscountAutomaticConnection and DiscountAutomaticEdge types are also removed, because no other fields in the schema return them.
（API バージョン 2027-01 で、automaticDiscounts は QueryRoot からなくなります。2027-01 で automaticDiscounts を含むリクエストは、データではなく検証エラーを返します。DiscountAutomaticConnection と DiscountAutomaticEdge の型も削除されます。スキーマ内でほかにこれらを返すフィールドが無いためです）

QueryRoot から automaticDiscounts が消える
2027-01 で automaticDiscounts を含むリクエストは、データではなく検証エラーを返す
2つの型に依存する型は、2027-01 で作り直すと壊れる

対象は、automaticDiscounts を呼ぶアプリです

ツールと生成した型も含みます。

This removal affects any app that calls automaticDiscounts and requests API version 2027-01 or later, including apps pinned to unstable once 2027-01 is the latest version. It also affects tooling and generated types that reference DiscountAutomaticConnection or DiscountAutomaticEdge.
（この削除は、automaticDiscounts を呼び、API バージョン 2027-01 以降を指定するすべてのアプリに影響します。2027-01 が最新バージョンになった時点で unstable に固定しているアプリも含みます。DiscountAutomaticConnection または DiscountAutomaticEdge を参照するツールや生成した型にも影響します）

2027-01 以降を指定して automaticDiscounts を呼ぶアプリ
unstable に固定したアプリ — 2027-01 が最新になった時点で対象
DiscountAutomaticConnection・DiscountAutomaticEdge を参照するツールと生成した型

対象外は3つ。

Apps that request 2026-10 or earlier continue to work as long as those versions are supported. Apps that already read automatic discounts through discountNodes don’t need to change anything.
（2026-10 以前を指定するアプリは、それらのバージョンがサポートされている限り動き続けます。すでに discountNodes で自動割引を読んでいるアプリは、何も変える必要がありません）

2026-10 以前を指定するアプリ — サポートされている間は動く
すでに discountNodes で自動割引を読むアプリ — 変更なし
automaticDiscounts を呼ばないアプリ — 対応なし

If your app doesn’t call automaticDiscounts, you don’t need to take action for this change.
（アプリが automaticDiscounts を呼んでいなければ、この変更への対応は要りません）

移行は4つの手順です

公式の手順を、そのまま並べます。

To migrate:
Search your app for automaticDiscounts, including generated GraphQL types and any references to DiscountAutomaticConnection or DiscountAutomaticEdge.
Replace the query with discountNodes and pass query: “method:automatic”. Move your existing inline fragments one level deeper, onto the discount field of DiscountNode.
Regenerate your GraphQL types or schema snapshot against 2027-01 so your types match the new shape.
Test against 2027-01 in a development store and confirm that the results match what your app returned on 2026-10.
（移行の手順: アプリ内の automaticDiscounts を探します。生成した GraphQL の型と、DiscountAutomaticConnection・DiscountAutomaticEdge への参照も含めます。クエリを discountNodes に置き換え、query: “method:automatic” を渡します。既存のインラインフラグメントは1段深く、DiscountNode の discount フィールドの下へ移します。GraphQL の型やスキーマのスナップショットを 2027-01 で作り直し、型を新しい形に合わせます。開発ストアで 2027-01 に対して試し、2026-10 でアプリが返していた結果と一致するかを確かめます）

automaticDiscounts を探す。生成した型と、2つの型への参照も含める
discountNodes に置き換えて query: "method:automatic" を渡し、インラインフラグメントを DiscountNode の discount の下へ1段下げる
型やスキーマのスナップショットを 2027-01 で作り直す
開発ストアの 2027-01 で試し、2026-10 の結果と突き合わせる

インラインフラグメントは、そのまま使えます

変わるのは、置き場所だけ。

公式の例は、DiscountAutomaticBxgy を読むクエリです。

変更前（2026-10 以前）: automaticDiscounts(first: 10) { nodes { ... on DiscountAutomaticBxgy { title status } } }
変更後（2027-01）: discountNodes(first: 10, query: "method:automatic") { nodes { id discount { ... on DiscountAutomaticBxgy { title status } } } }

The inline fragments carry over unchanged. You move them from the nodes under automaticDiscounts to the discount field of each DiscountNode. If your app reads more than one automatic discount type, add one inline fragment per type on discount, or select shared fields through the interfaces those types implement.
（インラインフラグメントは変更なしで引き継げます。automaticDiscounts の下の nodes から、各 DiscountNode の discount フィールドへ移します。自動割引の型を複数読む場合は、discount に型ごとのインラインフラグメントを1つずつ足すか、それらの型が実装するインターフェースを通して共通のフィールドを選びます）

型を複数読むなら、discount に型ごとのインラインフラグメントを足す
または、型が実装するインターフェースで共通のフィールドを選ぶ

間に合わないなら、2026-10 以前に留めます

移行を終えるまでの逃げ道。

If you can’t migrate before 2027-01, keep your app on 2026-10 or an earlier supported version that still includes automaticDiscounts until you complete the change.
（2027-01 より前に移行できない場合は、変更を終えるまで、automaticDiscounts を含む 2026-10 か、それより前のサポート中のバージョンにアプリを留めます）

移行しないまま 2027-01 に上げると、自動割引を読めなくなります

公式は、壊れ方まで書いています。

Before you upgrade your app to API version 2027-01, update any queries that call automaticDiscounts to use discountNodes with query: “method:automatic”, and regenerate your types against 2027-01. If you upgrade without migrating, those queries return validation errors and your app no longer reads automatic discounts.
（アプリを API バージョン 2027-01 に上げる前に、automaticDiscounts を呼ぶクエリをすべて query: “method:automatic” 付きの discountNodes に更新し、型を 2027-01 で作り直します。移行せずに上げると、それらのクエリは検証エラーを返し、アプリは自動割引を読めなくなります）

クエリ — 検証エラー
アプリ — 自動割引を読めなくなる

確かめ方も書かれています。

You can confirm the migration worked by running your updated queries against a development store on 2027-01 and checking that the automatic discount data matches what you saw on 2026-10.
（更新したクエリを開発ストアの 2027-01 で実行し、自動割引のデータが 2026-10 で見ていたものと一致するかを確かめれば、移行できたかを確認できます）

🔴 公式に書かれていないこと

2027-01 がいつ公開されるかは、この Changelog には書かれていません
2026-10 がいつまでサポートされるかは書かれていません。原文は “while those versions are supported” と書くだけです
automaticDiscountNodes がいつ削除されるかは書かれていません。原文は “later when that query is removed” と書くだけです
どのアプリが automaticDiscounts を使っているかは書かれていません
店主の管理画面や、店の割引そのものに変化があるかは書かれていません。書かれているのは、移行しないまま 2027-01 に上げたアプリが自動割引を読めなくなる “your app no longer reads automatic discounts” ことだけです
関連ドキュメントへのリンクの先は、本記事では読んでいません
🔴 本記事は日本のストアで確認していません。上の記載が無いことをもって「影響がある」とも「影響がない」とも書きません