DiscountsのRollouts対応：2026-10 API変更点

11月 03, 2026

DISCOUNTS / ROLLOUTS

DiscountsがRolloutsに対応
Admin GraphQL API 2026-10

割引のスケジュール管理がRollout連携で拡張。アプリ側の対応が必須です。

Admin GraphQL API 2026-10 から、すべての Discount タイプに読み取り専用の rollouts コネクションが追加されました。Rollout 経由で割引が管理されている場合、ネイティブの日付フィールドだけでは実際の提供期間・到達範囲を正確に把握できなくなるため、割引を読み取るアプリはすべて対応が必要です。対象はAPIバージョン 2026-10 以降で、既存インストール済みアプリはマーチャントの再認可が求められる場合があります。

1何が変わったのか：Before / After

2業務に活かせる具体ユースケース

課題: セール開始に合わせて複数の変更（割引・バナー・価格改定）をまとめてリリースしたいが、タイミングのズレが生じやすい。
打ち手: 割引をRolloutに含めることで、他のストア変更と同一のスケジュール・ローンチ条件に揃えられる。アプリ側は Discount.rollouts でRolloutのスケジュールフィールドを読み取り、統合されたリリースタイムラインを表示する。
効果: 割引の開始・終了タイミングが他施策と整合し、オペレーションミスを減らせる。
技術メモ: Rollout のスケジュールフィールドと startsAt / endsAt を組み合わせて読む必要がある。どちらか一方のみでは実際の可用性を正確に反映できない。

課題: 新しい割引施策を全バイヤーに一度に適用するリスクを避け、まず一部ユーザーで効果測定したい。
打ち手: RolloutのトラフィックスプリットでバイヤーをA/Bグループに分割し、割引の適用有無を制御する。アプリは effective allocation と treatment splits フィールドを読んで、どのグループに割引が届いているかを把握する。
効果: 割引の効果を限定公開で検証してから全体展開できるため、収益リスクを抑えた施策テストが可能になる。
技術メモ: 部分トラフィックのRollout有効化は Online Store のみ に適用される。100%トラフィックで有効化された場合は全販売チャネルで通常の割引適用ルールに従い利用可能。

課題: 期間限定イベント（ブラックフライデーなど）に合わせて割引を自動で有効化・無効化し、管理工数を削減したい。
打ち手: Rolloutに割引を含め、イベント期間のスケジュールを設定する。アプリ側では各Rolloutの change が割引を「有効化するか／期限切れにするか」を読み取り、ダッシュボードにステータスを反映する。
効果: 手動操作なしでイベント開始・終了に連動した割引制御が実現し、設定ミスや対応漏れのリスクが減る。
技術メモ: Rollout外の割引は従来どおりの挙動を維持する。Rolloutを割引から独立して発見・監視するには、Admin GraphQL API の Rollouts クエリおよびWebhookを使用する（元記事参照）。

3技術者向け対応ポイント

項目	内容	ステータス
対象APIバージョン	Admin GraphQL API 2026-10 以降	New
新規スコープ	`read_rollouts` をアプリのスコープに追加が必要。まずアクセスリクエストを行うこと。既存リソーススコープは引き続き適用される	要対応
既存インストール	既存インストール済みのアプリはマーチャントの再認可が必要になる場合がある	要確認
旧APIバージョンの挙動	2026-10より前のAPIバージョンでは、アクティブだが全バイヤーに届かない割引や、ネイティブ日付から推定されるステータスと実際のステータスが異なる割引がフィルタリングされる	注意
読み取るべきフィールド	`Discount.rollouts`（スケジュール・effective allocation・treatment splits・有効化/期限切れ判定）と `startsAt` / `endsAt` の組み合わせ	推奨
Rollout独立監視	割引を介さずRolloutを発見・変更通知を受け取るにはAdmin GraphQL APIのRolloutsクエリおよびWebhookを使用	参考

旧APIバージョン（2026-10未満）では、Rollout管理下にある割引が条件によってフィルタリングされる点に注意してください。移行の詳細は公式の「Discount Rollouts upgrade guide」を必ず確認することを推奨します。本記事は独立系メディアによる解説であり、最終判断は公式ドキュメントでご確認ください。

割引管理アプリはAdmin GraphQL API 2026-10への移行とread_rolloutsスコープ追加により、Rollout連携した正確な割引スケジュール・到達範囲の把握が可能になり、協調リリースや段階的テストを安全に実装できます。

Source: https://shopify.dev/changelog/discounts-can-now-be-included-in-rollouts | 公開日: 2026年10月01日