B2B顧客のロケーションアクセス権が変更
所属ロケーションのみ参照可能に
Customer Account API 全バージョン対象。クエリ変更は不要だが、返却データの範囲が縮小される。
このアップデートはB2Bアプリ・ストアフロントを開発しているすべての開発者が対象です。2026年11月17日以降、Customer Account APIの全バージョンで、B2B顧客が参照できる会社データと注文の範囲が「自分が所属するもの」のみに絞られます。スキーマ変更はなく、クエリ修正も不要ですが、返却される値がnull・空リスト・件数減少になるケースがあるため、フロントエンドの挙動を事前に確認してください。
1変更内容の図解:Before / After
2業務に活かせる具体ユースケース
- 課題
- B2Bストアフロントで、あるコンタクト経由で別コンタクトのロケーション情報(税務IDなど)が参照できてしまうセキュリティ上の懸念があった。
- 打ち手
- 今回の変更により、
CompanyContact.locationsは自分自身のコンタクトのみを返すよう制限された。アプリ側でのフィルタ実装は不要になる。 - 効果
- 不要なデータ漏えいリスクを排除しつつ、スキーマ変更なしで既存クエリをそのまま利用できる。セキュリティ要件の説明コストが削減できる。
- 技術メモ
- 返却が空リストになる場合に UI 上でエラーとならないよう、フロントエンドで「0件時の表示」を設計しておくことを推奨。
- 課題
- 従業員が退職・異動などで会社のコンタクトから削除された後も、その会社向けの注文履歴をAPIから取得できてしまうという業務上のリスクがあった。
- 打ち手
- マーチャントが顧客を会社から削除すると、
order(id:)/draftOrder(id:)はその会社の注文を返却拒否し、customer.orders/customer.draftOrdersからも会社注文が除外される。 - 効果
- 退社済み従業員による注文データへの不正アクセスを防止。個人注文は引き続き表示されるため、顧客体験を損なわずにアクセス制御を実現できる。
- 技術メモ
- 注文履歴ページで会社注文のカウントを表示している場合、件数が変動する可能性がある。表示ロジックの確認を推奨。
- 課題
- 複数ロケーションを持つ法人顧客が自分にロールのないロケーションのコンタクト一覧や税務情報を誤って参照・編集しようとする操作が発生していた。
- 打ち手
- ロールのないロケーション上の
taxIdentifier・contacts・roleAssignmentsフィールドは null または空リストを返すようになり、表示・操作の対象外となる。 - 効果
- UI側で「表示するデータがない」状態を正しく扱うだけで、過剰な権限表示を防止できる。アプリに追加の権限チェックロジックを実装する必要がなくなる。
- 技術メモ
-
Company.locationsとcompanyLocation(id:)は現在の顧客がロールを持つロケーションのみ返す点も合わせて確認すること。
3技術者目線のチェックポイント
| 確認項目 | 詳細 | 対応要否 |
|---|---|---|
| スキーマ変更 | フィールドの追加・削除・型変更はなし。返却値の内容のみ変化する。 | 対応不要 |
| クエリ変更 | 既存のGraphQLクエリをそのまま使用可能。書き換えは不要。 | 対応不要 |
| null / 空リスト対応 | ロールなしロケーションの taxIdentifier, contacts, roleAssignments が null または [] になる。フロントエンドの null ガード・空配列ハンドリングを確認する。 | 要確認 |
| 注文履歴の件数変動 | 退社済みの会社注文が customer.orders / customer.draftOrders から除外される。件数表示やページネーションロジックへの影響を確認する。 | 要確認 |
| 対象APIバージョン | Customer Account API の全バージョンが対象。特定バージョンへのピン留めでは回避できない。 | 注意 |
| purchasingEntity 経由のアクセス | 注文の purchasingEntity からロケーションの税・コンタクトデータを読み取っている場合は null が返る可能性あり。該当ロジックを洗い出すこと。 | 要確認 |
-
CompanyContact.locations→ 自分のコンタクトのみ -
Company.locations→ 自分がロールを持つもののみ -
companyLocation(id:)→ 自分がロールを持つもののみ -
taxIdentifier→ null(ロールなし時) -
contacts→ [](ロールなし時) -
roleAssignments→ [](ロールなし時) -
order(id:)/draftOrder(id:)→ 退社後の会社注文は拒否 -
customer.orders/customer.draftOrders→ 会社注文を除外
- 自分がロールを持つロケーションのデータ取得
- 個人注文(personal orders)の取得
- 自分自身のコンタクト情報の取得
- スキーマ定義・クエリ構文
- 会社データへのアクセス(所属会社のみ)
※ B2Bアプリに関係しないストアフロント実装はこの変更の影響を受けません。
Source: https://shopify.dev/changelog/updated-b2b-location-access-in-the-customer-account-api | 公開日: 2026年11月17日






Share:
EventBridge Webhookペイロード上限が1MBに拡大
Dev DashboardでUI拡張の読み込み失敗を可視化