開発者向けの変更です。
GraphQL Admin API 2027-01 から、Rollouts の変更ごとに、適用がうまくいったかを読めるようになります。
RolloutChange に applyResult が加わります
発表は2026年11月19日の developer changelog。
出典: Shopify developer changelog「RolloutChange now includes applyResult」2026年11月19日
https://shopify.dev/changelog/posts/rolloutchange-now-includes-applyresult
Version は「2027-01」、フラグは「New」です。
タグは「GraphQL Admin API」。
As of GraphQL Admin API version 2027-01, the RolloutChange interface has an applyResult field.
(GraphQL Admin API の 2027-01 から、RolloutChange インターフェースに applyResult フィールドが加わります)
対象は RolloutChange インターフェースの applyResult。
適用は全ての購入者への変更を確定させる操作です
ロールアウトを適用すると、トリートメントの変更が全ての購入者に対して確定します。
Applying a rollout makes a treatment’s changes permanent for every buyer.
(ロールアウトを適用すると、トリートメントの変更が全ての購入者に対して恒久的になります)
applyResult が示すのは、変更ごとの最新の適用の試みの結果。
applyResult shows the outcome of the latest attempt to apply each change, so your app can find changes that failed.
(applyResult は、変更ごとの最新の適用の試みの結果を示すので、アプリは失敗した変更を見つけられます)
失敗した変更を見つけられる点が、今回の要点です。
結果は3つの欄で返ります
中身の型は RolloutChangeApplyResult です。
status/IN_PROGRESS・SUCCESS・FAILUREのどれかcompletedAt/試みが終わった時刻errorCode/失敗の理由が分かるときの理由
completedAt は、途中のときと時刻が残らなかったときは null。
errorCode: why the change failed, when known: RESOURCE_NOT_FOUND, VALIDATION_FAILED, LIMIT_EXCEEDED, INVALID_CHANGE or INTERNAL_ERROR.
(errorCode:変更が失敗した理由。分かるときは RESOURCE_NOT_FOUND・VALIDATION_FAILED・LIMIT_EXCEEDED・INVALID_CHANGE・INTERNAL_ERROR のどれか)
理由の値は5つ。
null になる場面は2つあります
1つ目は、まだ一度も適用を試していないときです。
2つ目は、オンラインアクセストークンで呼び、スタッフが変更先のリソースを読めないとき。
applyResult is null before the first attempt to apply the change. With an online access token, it’s also null if the staff member can’t read the changed resource.
(applyResult は、変更の適用を初めて試す前は null です。オンラインアクセストークンでは、スタッフが変更先のリソースを読めないときも null になります)
スコープは今の read_rollouts のままです
新しいアクセススコープは要りません。
It uses the existing read_rollouts access scope.
(今ある read_rollouts のアクセススコープを使います)
開発者と店がやることを整理します
開発者がやることは次の3つです。
- Rollouts を扱うアプリなら、2027-01 で
applyResultを読む処理を足す statusがFAILUREの変更を拾い、errorCodeを店に分かる言葉で見せる- null を「まだ試していない」か「読む権限が無い」として扱い、失敗と分けて扱う
店がやることは次の1つです。
- Rollouts を使うアプリを使っているなら、適用の失敗を知らせる機能があるかをアプリの提供元に聞く
🔵 上の手順はキクシル編集部の整理で、公式の記載ではありません。
🔴 公式に書かれていないこと
次の点は、一次ソースにありません。
- Shopify の管理画面に、適用の失敗が表示されるかは書かれていません
- 失敗した変更を、もう一度適用し直す方法は書かれていません
- errorCode の5つの値それぞれが、どんな場面で返るかは書かれていません
- 2027-01 より前の API バージョンで、同じ結果を読む方法があるかは書かれていません
- 🔴 開発ストアでは試していません。記載が無いことをもって「できる」とも「できない」とも書きません
出典
- Shopify developer changelog「RolloutChange now includes applyResult」2026年11月19日
https://shopify.dev/changelog/posts/rolloutchange-now-includes-applyresult
上記の Shopify 公式の情報だけを一次情報として使っています。

