開発者向けの変更です
割引を読むアプリは、API 2026-10 から割引の Rollouts も読む必要があります。
Shopify は2026年10月1日に、開発者向けの Changelog に掲載しました。
出典: Shopify developer changelog「Discounts can now be included in Rollouts」2026年10月1日
https://shopify.dev/changelog/discounts-can-now-be-included-in-rollouts
- Version: 2026-10
- Flags: New / Action required
- Surfaces: API
- Affected APIs: Admin GraphQL API
店主は、割引を Rollouts に入れられます
公式が書いている店主側の変化は、これです。
Merchants can include discounts in Rollouts to coordinate launches, test discounts with a share of buyers, or run temporary events alongside other store changes.
(店主は割引を Rollouts に入れて、ほかのストアの変更と合わせた公開の調整、一部の購入者での割引のテスト、期間限定のイベントの実施ができます)
使い道は3つ。
- 公開のタイミングを、ほかの変更とそろえる
- 一部の購入者だけで割引を試す
- 期間限定のイベントを走らせる
割引の日付だけでは、使えるかどうかが決まりません
ここが変更の中心。
When a discount is part of a Rollout, its native dates alone don’t describe its availability.
(割引が Rollout に含まれるとき、割引そのものの日付だけでは、その割引が使えるかどうかを表せません)
割引を読むアプリには、Rollout の情報も合わせて読むよう求めています。
Apps that read discounts should use Discount.rollouts alongside existing discount fields to account for Rollout-driven schedules and buyer reach.
(割引を読むアプリは、Rollout による日程と購入者への届き方を反映するため、既存の割引のフィールドと合わせて Discount.rollouts を使うべきです)
アプリ側の対応は3段階です
公式の手順は、次のとおり。
read_rolloutsをアプリのスコープに足す- 既存のインストールでは、店主の再承認が要る場合がある
Discount.rolloutsで、どの Rollout が割引に効いているかを調べる- Rollout の日程を、割引の
startsAt・endsAtと合わせて読む - 実効の配分、treatment の割合、その変更が割引を有効にするか終わらせるかも読む
設定値と実効値は別物。
Configured traffic allocation alone does not determine effective reach.
(設定上のトラフィック配分だけでは、実際にどこまで届くかは決まりません)
一部の購入者だけに出す割引は、オンラインストアに限られます
販売チャネルによって、効き方が変わります。
Discounts activated at 100% effective traffic are available across all sales channels, subject to normal discount eligibility rules. Partial-traffic Rollout activation applies on the Online Store only.
(実効トラフィック100%で有効になった割引は、通常の割引の適用条件のもとで、すべての販売チャネルで使えます。一部のトラフィックだけに有効にする Rollout は、オンラインストアだけに適用されます)
- 全員に行き渡った割引 — すべての販売チャネル
- 一部の購入者だけの割引 — オンラインストアだけ
- Rollout に入っていない割引 — これまでどおり
Discounts outside Rollouts behave as before.
(Rollouts に入っていない割引は、これまでどおりに動きます)
古い API バージョンでは、一部の割引が結果から外れます
対応しないアプリにも、影響が出ます。
On Admin GraphQL API versions earlier than 2026-10, discounts are filtered out if they are active but may not reach all buyers, or if their status differs from the status inferred from native dates.
(2026-10 より前の Admin GraphQL API では、有効でもすべての購入者に届かない可能性がある割引や、状態が日付から推定される状態と違う割引は、結果から除外されます)
外れる割引は2種類。
- 有効でも、すべての購入者に届かない可能性がある割引
- 状態が、日付から推定される状態と違う割引
Rollouts そのものを読む API も、同じ日に出ています
同じ日付で「Rollouts queries and webhooks in the Admin GraphQL API」も掲載されました。
出典: Shopify developer changelog「Rollouts queries and webhooks in the Admin GraphQL API」2026年10月1日
https://shopify.dev/changelog/read_rollouts
Apps can now discover Rollouts, inspect their schedules, traffic allocation, and resource changes, and receive notifications when they change.
(アプリは Rollouts を見つけ、その日程、トラフィック配分、リソースの変更を調べ、変更があったときに通知を受け取れるようになりました)
できることは4つ。
rolloutsとrollout(id:)で、Rollout を一覧・検索・取得する- treatment ごとに、割引・カタログ・テーマ・チェックアウトとアカウントの設定への影響を読む
- 予定の開始と終了の時刻、設定上の配分、実効の配分、treatment の割合を読む
- Rollout の webhooks で、ライフサイクル・実効配分・リソース変更の通知を受け取る
🔴 公式に書かれていないこと
- 店主が管理画面のどこで Rollouts を作るかは書かれていません
- 使えるプランの条件は書かれていません
- 日本のストアで使えるかは書かれていません
- どの割引アプリが対応したかは書かれていません
- 再承認がどのアプリで必要になるかは書かれていません。原文は “may need merchant reauthorization” だけです
- 購入者の側で割引がどう見えるかは書かれていません
- アップグレードガイドと Rollout API のリファレンスはリンク先にあり、本記事は読んでいません
- 🔴 本記事は日本のストアで確認していません。上の記載が無いことをもって「使える」とも「使えない」とも書きません
店がやること
- 割引を扱うアプリを入れている店は、アプリの提供元に API 2026-10 への対応予定を聞く
- アプリから再承認を求められたら、求める権限が Rollouts の読み取りかを見てから承認する
- Rollouts で一部の購入者だけに割引を出すときは、オンラインストア以外では効かない前提で組む
🔵 上の手順はキクシル編集部の整理で、公式の記載ではありません。
出典
- Shopify developer changelog「Discounts can now be included in Rollouts」2026年10月1日
https://shopify.dev/changelog/discounts-can-now-be-included-in-rollouts - Shopify developer changelog「Rollouts queries and webhooks in the Admin GraphQL API」2026年10月1日
https://shopify.dev/changelog/read_rollouts
上記の Shopify 公式の情報だけを一次情報として使っています。
次の事項は「未確認」として扱い、推測で補っていません。
- 管理画面での Rollouts の作り方
- プランの条件
- 日本のストアでの提供
- 対応した割引アプリ
- 再承認が要るアプリ
- 購入者側の見え方

