
Shopify、サーバーピクセル更新APIにユーザーアクセス必須化 猶予期間なし
ShopifyAdmin APIアクセストークン破壊的変更EC
Shopifyは11月20日、GraphQL Admin APIのeventBridgeServerPixelUpdateとpubSubServerPixelUpdateで、アプリへのアクセス権を持たないユーザーのオンラインアクセストークンを拒否する変更を適用した。セキュリティ修正のため全APIバージョンが対象で、非推奨期間は設けられない。オフラインアクセストークンの利用か、該当スタッフへのアプリアクセス付与が必要になる。
何が発表されたか
Shopifyは2026年11月20日、GraphQL Admin APIの eventBridgeServerPixelUpdate と pubSubServerPixelUpdate の2つのミューテーションについて、アプリへのアクセス権を持たないユーザーのオンラインアクセストークンを拒否する変更を適用した。
変更の要点は以下の通り。
- 適用開始は 2026年11月20日。
- すべてのGraphQL Admin APIバージョンが対象。Shopifyはセキュリティ修正であるため非推奨期間(deprecation period)を設けないとしている。
- 必要になるのは、オフラインアクセストークン、またはアプリへのアクセス権を持つユーザーのオンラインアクセストークンのいずれか。
write_pixels、read_customer_events、write_server_pixelsのスコープ要件は変更されない。- チェックに失敗した場合、ミューテーションはペイロードを返さず access denied エラーを返す。サーバーピクセルのエンドポイント自体は変わらない。
- このエラーメッセージはスコープ不足時のものと同一で、ユーザーアクセスが原因であることは示されない。
取るべき対応
影響を受けるのは、これら2つのミューテーションを、アプリへのアクセス権がないスタッフのオンライントークンで呼び出しているアプリである。自社ストア向けのカスタムアプリや、サーバーピクセルの設定をAdmin API経由で書き換えている連携が該当しやすい。
Shopifyが示す対応は2通りある。
- 該当するスタッフアカウントにアプリへのアクセス権を付与する
- バックグラウンドジョブなどから オフラインアクセストークンで呼び出す構成に変える
加えて、どちらを選ぶ場合でも access denied エラーのハンドリングを実装しておくことが求められている。エラーメッセージがスコープ不足時と区別できない仕様のため、原因の切り分けには注意が必要になる。スコープ設定を見直しても解決しない場合は、トークンの種類とユーザーのアプリアクセス権を確認する順序になる。
猶予期間が設けられていないため、該当する実装がある場合は適用済みの状態で動作を確認するのが先になる。発表には、適用開始日以外の期限は記載されていない。
