automaticDiscountsクエリ廃止と
discountNodesへの移行ガイド
GraphQL Admin API 2027-01で自動割引クエリが完全削除。今すぐ対応を。
GraphQL Admin API バージョン 2027-01 から、automaticDiscounts クエリが完全に削除されます。automaticDiscounts を呼び出しているアプリは、2027-01 へアップグレードする前に discountNodes(query: "method:automatic" フィルター付き)への移行が必要です。2026-10 以前のバージョンを使用しているアプリはサポート期間中は影響を受けません。
1変更内容 Before / After 図解
インラインフラグメント(... on DiscountAutomaticBxgy)はそのまま流用可。nodes 直下から DiscountNode.discount フィールド配下に1段深くなるだけです。
2業務に活かせる具体ユースケース
- 課題
- 自動割引の一覧を取得して管理画面に表示している既存アプリが、2027-01へのアップグレード後にデータ取得できなくなる
- 打ち手
-
automaticDiscountsをdiscountNodes(query: "method:automatic")に置き換え、既存のインラインフラグメントをdiscountフィールド配下に移動する - 効果
- 2027-01以降も割引一覧の取得が継続でき、アプリのダウンタイムゼロで移行完了
- 技術メモ
- 生成済みのGraphQL型(DiscountAutomaticConnection / DiscountAutomaticEdgeへの参照)も削除されるため、スキーマスナップショットの再生成が必須
- 課題
- コード割引と自動割引の両方を取得するために別々のクエリを使っており、マージ処理が複雑化している
- 打ち手
-
discountNodes単一クエリに統合。自動割引はquery: "method:automatic"、コード割引はquery: "method:code"、両方取得時はフィルターを外す - 効果
- クエリ数削減・ページネーションロジック統一・将来の新割引タイプ追加時も対応不要
- 技術メモ
- フィルターには
status・discount_type・discount_class・created_at・starts_atが利用可。構文はShopify API search syntaxに準拠
- 課題
-
automaticDiscountNodesへ移行済みのアプリが「今回の変更は影響なし」と安心しているが、同クエリも非推奨であり将来また移行が発生する - 打ち手
- 今回の移行タイミングで
automaticDiscountNodesも使わず、直接discountNodesへ移行する。二度手間を避けるための先行対応 - 効果
- 次回の廃止サイクルでの追加工数ゼロ。クエリ語彙が
discountNodes一本に統一される - 技術メモ
- 元記事によれば
automaticDiscountNodesもいずれ削除予定。今回の削除対象には含まれないが、早期移行を公式が推奨している
3技術者目線のポイント
🗑 削除される型
-
QueryRoot.automaticDiscountsフィールド -
DiscountAutomaticConnection型 -
DiscountAutomaticEdge型
これらを参照するコード生成スナップショットは2027-01では型エラーになります
⚠️ バリデーションエラーの挙動
2027-01に対して automaticDiscounts を含むクエリを送信すると、データではなくバリデーションエラーが返ります。サイレントな動作変更ではないため、テスト環境での早期確認が重要です。
📋 移行チェックリスト
- コード内の
automaticDiscounts文字列を全検索 -
DiscountAutomaticConnection/DiscountAutomaticEdgeの参照箇所を特定 - クエリを
discountNodesに置換しフラグメントを1段深く移動 - 2027-01スキーマで型を再生成
- 開発ストアで2027-01に対して動作確認
🔄 バージョン互換性まとめ
| APIバージョン | automaticDiscounts | discountNodes |
|---|---|---|
| 2026-10以前 | ✅ 動作 | ✅ 動作 |
| 2027-01以降 | ❌ エラー | ✅ 動作 |
移行が間に合わない場合は2026-10以前に留まることが公式推奨
🏷 discountNodesの対応フィルター
構文詳細はShopify API search syntaxドキュメントを参照
4影響を受けるケース / 受けないケース
| 状況 | 影響 | 対応 |
|---|---|---|
automaticDiscounts を呼び出しており2027-01へアップグレード予定 |
要対応 |
discountNodesへ移行必須 |
automaticDiscounts を使用、2026-10以前に留まる |
一時的に不要 | サポート終了前に移行計画を |
discountNodes を既に使用 |
影響なし | 対応不要 |
automaticDiscountNodes を使用 |
今回は影響なし | 将来の削除に備え早期移行推奨 |
DiscountAutomaticConnection 型を生成コードで参照 |
要対応 | スキーマ再生成が必要 |
automaticDiscounts を呼び出していない |
影響なし | 対応不要 |
automaticDiscounts を discountNodes(query: "method:automatic") へ置き換えることで、割引取得機能を継続しながらコード割引との統合クエリも実現できます。Source: https://shopify.dev/changelog/automaticdiscounts-query-is-removed-in-api-version-2027-01 | 公開日: 2026年9月18日






Share:
Metafieldにtranslatableフィールドが追加 — 翻訳判定が1行で完結
UIエクステンションのバンドルサイズ上限と例外申請