MENU
  • TOP
  • ECサイト
  • shopify
  • – ECサイト制作
ECサイトshopifyならキクシル
ECサイトshopifyならキクシル
  • TOP
  • ECサイト
  • shopify
  • – ECサイト制作
ECサイトshopifyならキクシル
  • TOP
  • ECサイト
  • shopify
  • – ECサイト制作
  1. ホーム
  2. Shopifyニュース
  3. 【Shopify最新ニュース2026・開発者向け】API 2027-01 で、Rollouts の変更の適用結果を applyResult で読めるように

【Shopify最新ニュース2026・開発者向け】API 2027-01 で、Rollouts の変更の適用結果を applyResult で読めるように

2026 11/21
2026年11月21日
Shopifyニュースのアイキャッチ:紺色の台に敷いた灰色のフェルトの上で、テープで閉じた段ボール箱に両手を置く写真に「Rollouts の変更の適用結果を読める API 2027-01 から」の見出し

開発者向けの変更です。

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つです。

  1. Rollouts を扱うアプリなら、2027-01 で applyResult を読む処理を足す
  2. status が FAILURE の変更を拾い、errorCode を店に分かる言葉で見せる
  3. null を「まだ試していない」か「読む権限が無い」として扱い、失敗と分けて扱う

店がやることは次の1つです。

  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 公式の情報だけを一次情報として使っています。

Shopifyニュース
API変更 shopify Shopifyアプリ
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
  • 【Shopify最新ニュース2026・開発者向け】サーバーピクセルの更新2つにアプリへのユーザーアクセスが必要に
  • お店の文字を整える — テーマのフォントを変える手順

この記事を書いた人

テスタのアバター テスタ

さっぱりした性格で、率直。テンションは一定で、感情に流されない。褒めるときは短く的確、厳しいこともちゃんと言うが、人格否定はしないフェアさがある。遠回りが嫌いで、結論までの道筋をシンプルにしたがる。

関連記事

  • Shopifyニュースのアイキャッチ:木の机の上で、クラフト紙に包んだ陶器のマグカップを両手で持つ写真に「サーバーピクセル更新 ユーザーアクセスが必要に」の見出し
    【Shopify最新ニュース2026・開発者向け】サーバーピクセルの更新2つにアプリへのユーザーアクセスが必要に
    2026年11月21日
  • Shopifyニュースのアイキャッチ:灰色の石の台の上で、白い箱にたたんだ麻の布を詰める両手の写真に「統合レシートエディタなら POS の送るレシートが印刷と同じ内容に」の見出し
    【Shopify最新ニュース2026】Shopify POS、統合されたレシートエディタを使っている場合はメールとテキストのレシートが印刷レシートと同じ内容に
    2026年11月21日
  • Shopifyニュースのアイキャッチ:傷のある木の机の上で、薄紙の入った小さな段ボール箱を両手で開ける写真に「Shopify Flow に8つの更新トリガー」の見出し
    【Shopify最新ニュース2026】Shopify Flow に注文や顧客など8つの「更新」トリガーが追加
    2026年11月21日
  • Shopifyニュースのアイキャッチ:竹のすだれの上で、クラフト紙の封筒と薄紙に並ぶ小さな丸い缶に手を添える写真に「定期購入の更新でストアクレジットが選べる」の見出し
    【Shopify最新ニュース2026・開発者向け】定期購入の更新にストアクレジットを使えるように、API に allowStoreCredit
    2026年11月20日
  • Shopifyニュースのアイキャッチ:段ボール箱の中のベージュのスニーカーに両手を添える写真に「カゴ落ちの回復URLに顧客データの承認が必要」の見出し
    【Shopify最新ニュース2026・開発者向け】abandonedCheckoutUrl を読むアプリに、顧客データ4項目の承認が必要に
    2026年11月20日
  • Shopifyニュースのアイキャッチ:紺色の台の上で、灰色のニットを白い薄紙で包む両手と段ボール箱の写真に「12月1日以降の新しいカスタムアプリに期限付きトークンが必須」の見出し
    【Shopify最新ニュース2026・開発者向け】12月1日以降に作るカスタムアプリは期限付きのオフライントークンが必須に
    2026年11月20日
  • Shopifyニュースのアイキャッチ:木の机の上で、クラフト紙に包んだ陶器のマグカップを両手で持つ写真に「ストアで動くアプリに接続先の宣言が必須に」の見出し
    【Shopify最新ニュース2026・開発者向け】オンラインストアで動くアプリに network access の宣言が必須に
    2026年11月20日
  • Shopifyニュースのアイキャッチ:灰色の台の上で、段ボール箱の中のニットを包む薄紙を整える両手の写真に「下書き注文APIの割引にスタッフ権限が必要に」の見出し
    【Shopify最新ニュース2026・開発者向け】下書き注文の API で割引を足すには、スタッフの権限が必要に
    2026年11月19日

最近の投稿

  • Shopify のスタッフのアカウントを見直す — 役割と許可、プランごとの人数の上限
  • お店の文字を整える — テーマのフォントを変える手順
  • 【Shopify最新ニュース2026・開発者向け】API 2027-01 で、Rollouts の変更の適用結果を applyResult で読めるように
  • 【Shopify最新ニュース2026・開発者向け】サーバーピクセルの更新2つにアプリへのユーザーアクセスが必要に
  • 【Shopify最新ニュース2026】Shopify POS、統合されたレシートエディタを使っている場合はメールとテキストのレシートが印刷レシートと同じ内容に

運営: 株式会社ギャザリング

  • プライバシーポリシー
  • 運営者情報
  • お問い合わせ

© ECサイトshopifyならキクシル.

目次