開発者向けの変更です。
サーバーピクセルを更新する2つの mutation が、アプリにアクセスできないスタッフのオンラインアクセストークンを拒むようになりました。
2026年11月20日から全ての API バージョンで始まっています
発表は2026年11月20日の developer changelog。
出典: Shopify developer changelog「
eventBridgeServerPixelUpdateandpubSubServerPixelUpdatenow require user access to the app」2026年11月20日
https://shopify.dev/changelog/posts/eventbridgeserverpixelupdate-and-pubsubserverpixelupdate-now-require-user-access-to-the-app
フラグは「Breaking API Change」と「Action required」。
タグは「Security」と「GraphQL Admin API」です。
Starting November 20, 2026, the eventBridgeServerPixelUpdate and pubSubServerPixelUpdate mutations reject online access tokens for users who don’t have access to the app. The change applies to all GraphQL Admin API versions.
(2026年11月20日から、eventBridgeServerPixelUpdate と pubSubServerPixelUpdate の mutation は、アプリにアクセスできないユーザーのオンラインアクセストークンを拒みます。この変更は、全ての GraphQL Admin API のバージョンに当たります)
対象は eventBridgeServerPixelUpdate と pubSubServerPixelUpdate の2つ。
通るのは2種類のトークンです
呼べるのは、オフラインアクセストークンか、アプリにアクセスできるユーザーのオンラインアクセストークン。
Both mutations now require an offline access token, or an online access token for a user who has access to the app.
(どちらの mutation も、オフラインアクセストークンか、アプリにアクセスできるユーザーのオンラインアクセストークンが必要になります)
次の3つのアクセススコープの条件は変わりません。
write_pixelsread_customer_eventswrite_server_pixels
ユーザーアクセスの不足とはエラーに出ません
拒まれたときは、アクセス拒否のエラーが返ります。
The error message is the same one you get for a missing access scope, so it doesn’t mention user access.
(エラーの文面は、アクセススコープが足りないときと同じで、ユーザーアクセスには触れません)
payload は返らない形。
サーバーピクセルの送り先も、元のままです。
スコープ不足とは、文面では見分けられない点が、調べるときの落とし穴。
アプリにアクセスできないスタッフのオンライントークンで呼ぶアプリが対象です
影響を受けるのは、アプリにアクセスできないスタッフのオンラインアクセストークンで呼ぶアプリ。
Offline access tokens, and online access tokens for users who have access to the app, work as before.
(オフラインアクセストークンと、アプリにアクセスできるユーザーのオンラインアクセストークンは、今までどおり動きます)
公式の対応は次の2つです。
- そのスタッフが、Shopify の管理画面でアプリにアクセスできるようにする
- バックグラウンドの処理などから、オフラインアクセストークンで呼ぶ
どちらの場合も、アクセス拒否のエラーを受け止める処理を入れます。
作成と削除と同じ確認が更新にも入ります
serverPixelCreate と serverPixelDelete には、すでに同じ確認がありました。
This is a security fix, so it applies to all API versions without a deprecation period.
(セキュリティの修正なので、非推奨の期間を置かずに全ての API バージョンに当たります)
ねらいは、ピクセルの送り先を変えられる人を絞ること。
アプリにアクセスできるユーザーだけが、送り先を変えられます。
オンライントークンで呼ぶアプリでは、スタッフのアプリへのアクセスが対応の1つです
公式は、管理画面でスタッフにアプリへのアクセスを持たせることを、対応の1つに挙げています。
make sure the staff member has access to your app in the Shopify admin
(そのスタッフが、Shopify の管理画面でアプリにアクセスできるようにしてください)
もう1つの手は、オフラインアクセストークンで呼ぶこと。
開発者と店がやることを整理します
開発者がやることは次の3つです。
- この2つの mutation をオンラインアクセストークンで呼んでいる箇所を探す
- スタッフにアクセスがあるか、オフラインアクセストークンで呼ぶかを決める
- アクセス拒否のエラーを受け止め、スタッフに分かる言葉で知らせる
店がやることは次の1つです。
- サーバーピクセルを使うアプリでエラーが出たら、そのスタッフがアプリにアクセスできるかを見る
🔵 上の手順はキクシル編集部の整理で、公式の記載ではありません。
🔴 公式に書かれていないこと
次の点は、一次ソースにありません。
- 店の管理画面で、スタッフのアプリへのアクセスをどこで変えるかは書かれていません
- エラーのコードや文面そのものは書かれていません。スコープ不足と同じ文面とだけあります
- どのアプリが影響を受けるかを店が調べる方法は書かれていません
- アプリ開発者から店への連絡があるかは書かれていません
- 🔴 開発ストアでは試していません。記載が無いことをもって「できる」とも「できない」とも書きません
出典
- Shopify developer changelog「
eventBridgeServerPixelUpdateandpubSubServerPixelUpdatenow require user access to the app」2026年11月20日
https://shopify.dev/changelog/posts/eventbridgeserverpixelupdate-and-pubsubserverpixelupdate-now-require-user-access-to-the-app
上記の Shopify 公式の情報だけを一次情報として使っています。

