bulk クエリと bulk ミューテーションは、それぞれ Partner Dashboard でアクセスを有効化しないと access denied エラーになる。全 API バージョンが対象。直近 31 日使っていない種類はアクセスを失う。
bulk operation を始めるのに、Partner Dashboard 側での事前許可は不要だった。
bulk クエリ・bulk ミューテーションそれぞれにアクセスが必要。無いまま開始すると access denied エラー。
bulkOperationRunQuery を実行するには bulk クエリへのアクセス が必要。
Partner Dashboard のボタン名 ： 「Allow bulk queries」
bulkOperationRunMutation を実行するには bulk ミューテーションへのアクセス が必要。
Partner Dashboard のボタン名 ： 「Allow bulk mutations」
Partner として開発し、bulk operations を実行する公開アプリ。
Partner として開発し、bulk operations を実行するカスタムアプリ。
Shopify 管理画面や Dev Dashboard でマーチャントが作成したアプリ。「現時点では」影響なし。
| 項目 | 内容 |
|---|---|
| 対象 API | GraphQL Admin API（bulk クエリ／bulk ミューテーション） |
| 対象 API バージョン | 全バージョン 古いバージョンに固定していても対象 |
| 開始時期 | 公開日（2026-11-06）当日から |
| 未許可時の挙動 | access denied エラー |
| アクセスの適用範囲 | アプリをインストールしている全ストア |
Shopify 側でアクセスを有効化済み。Partner Dashboard で状態を確認できる。
直近 31 日に bulk クエリ／bulk ミューテーションを実行していないアプリは、その操作種別へのアクセスを失う。再度有効化すれば戻せる。
Partner Dashboard の「Apps」を開き、対象アプリを選ぶ。
サイドバーにあるメニューから開く。
「Allow bulk queries」「Allow bulk mutations」の必要な方（または両方）をクリック。
bulkOperationRunQuery と bulkOperationRunMutation で必要なアクセスが分かれる。コードベースでどちらを呼んでいるか棚卸しする。
要件は GraphQL Admin API の全バージョンに適用。古いバージョンを使っていても同じく access denied になる。
直近 31 日未使用の操作種別はアクセスを失う。月次・四半期の移行バッチなど、たまにしか走らない処理は実行前に Partner Dashboard で状態確認が必要。
未許可だとリクエストが access denied で返る。エラーの具体的なコードや形式は記事に記載なしのため、ログ・アラートで bulk 開始失敗を検知できるようにしておく。
アプリ設定の変更・新バージョンリリース・マーチャントの再インストールは不要で、許可はインストール済みの全ストアに効く。デプロイを伴わない運用タスクとして扱える。マーチャント作成アプリ（管理画面／Dev Dashboard）は現時点で対象外。
bulkOperationRunQuery／bulkOperationRunMutation 呼び出しを洗い出し、各アプリの Partner Dashboard「API access requests」で有効状態と突き合わせる。