BREAKING CHANGE

automaticDiscountsクエリ廃止と
discountNodesへの移行ガイド

GraphQL Admin API 2027-01で自動割引クエリが完全削除。今すぐ対応を。

2026-10以前automaticDiscounts✅ 動作継続サポート期間中は有効2027-01automaticDiscounts❌ 完全削除バリデーションエラー返却移行先discountNodesquery:"method:automatic"コード割引も統合

GraphQL Admin API バージョン 2027-01 から、automaticDiscounts クエリが完全に削除されます。automaticDiscounts を呼び出しているアプリは、2027-01 へアップグレードする前に discountNodes(query: "method:automatic" フィルター付き)への移行が必要です。2026-10 以前のバージョンを使用しているアプリはサポート期間中は影響を受けません。

1変更内容 Before / After 図解

クエリ構造の変化❌ Before (〜2026-10)query {automaticDiscounts(first: 10) {nodes {... on DiscountAutomaticBxgy {titlestatus}}}}2027-01ではバリデーションエラー✅ After (2027-01〜)query {discountNodes(first: 10, query: "method:automatic") {nodes {iddiscount {... on DiscountAutomaticBxgy {title status}}} }}→

インラインフラグメント(... 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 を含むクエリを送信すると、データではなくバリデーションエラーが返ります。サイレントな動作変更ではないため、テスト環境での早期確認が重要です。

📋 移行チェックリスト

  1. コード内の automaticDiscounts 文字列を全検索
  2. DiscountAutomaticConnection / DiscountAutomaticEdge の参照箇所を特定
  3. クエリを discountNodes に置換しフラグメントを1段深く移動
  4. 2027-01スキーマで型を再生成
  5. 開発ストアで2027-01に対して動作確認

🔄 バージョン互換性まとめ

APIバージョン automaticDiscounts discountNodes
2026-10以前 ✅ 動作 ✅ 動作
2027-01以降 ❌ エラー ✅ 動作

移行が間に合わない場合は2026-10以前に留まることが公式推奨

🏷 discountNodesの対応フィルター

method:automaticmethod:codestatusdiscount_typediscount_classcreated_atstarts_at

構文詳細はShopify API search syntaxドキュメントを参照

4影響を受けるケース / 受けないケース

状況 影響 対応
automaticDiscounts を呼び出しており2027-01へアップグレード予定 要対応 discountNodesへ移行必須
automaticDiscounts を使用、2026-10以前に留まる 一時的に不要 サポート終了前に移行計画を
discountNodes を既に使用 影響なし 対応不要
automaticDiscountNodes を使用 今回は影響なし 将来の削除に備え早期移行推奨
DiscountAutomaticConnection 型を生成コードで参照 要対応 スキーマ再生成が必要
automaticDiscounts を呼び出していない 影響なし 対応不要
GraphQL Admin API 2027-01への移行前に automaticDiscounts を discountNodes(query: "method:automatic") へ置き換えることで、割引取得機能を継続しながらコード割引との統合クエリも実現できます。

Source: https://shopify.dev/changelog/automaticdiscounts-query-is-removed-in-api-version-2027-01 | 公開日: 2026年9月18日