配送プロファイルが全商品を一括カバー — GraphQL新フィールド解説

8月 06, 2026

API CHANGE

配送プロファイルが全商品を
一括カバーする新フィールド

coversAllItems で商品ごとの割り当て作業をゼロに

GraphQL Admin API バージョン 2026-07 から、アプリ所有の配送プロファイル（DeliveryProfile）に coversAllItems という真偽値フィールドが追加されました。このフィールドを true にすることで、ストア内の全ての配送可能な商品バリアントへ個別に割り当てを行わずとも、そのプロファイルの配送レートがチェックアウト時に適用されます。アプリ開発者にとっては配送設定ロジックの大幅な簡略化が期待できます。

OVERVIEW

01Before / After：何が変わったか

USE CASES

02業務に活かせるユースケース 3選

課題: 配送レートアプリが新商品追加のたびにプロファイルへの割り当て処理を走らせる必要があり、登録漏れで特定商品にレートが表示されないトラブルが発生していた。
打ち手: アプリ所有プロファイル作成時に coversAllItems: true を設定。以降は商品・バリアントの追加・削除に関わらず常に全商品へ自動適用される。
効果: 割り当て漏れによるチェックアウトエラーを根本的に解消。Webhook等で商品追加を検知してプロファイル更新する処理が不要になり、アプリの複雑性が低下する。
技術メモ: deliveryProfileCreate または deliveryProfileUpdate ミューテーションの DeliveryProfileInput に coversAllItems: true を含める。APIバージョン 2026-07 以降が必要。

課題: 大規模ストアでSKU数が数万に及び、配送プロファイルへの商品割り当てクエリがタイムアウトや負荷超過を引き起こしていた。
打ち手: アプリ所有プロファイルに coversAllItems: true を使用し、全バリアントを包括。個別のバリアントIDリストを管理・送信するバッチ処理自体を廃止する。
効果: プロファイル更新のAPIコール数を大幅削減。ペイロードサイズも縮小し、レートリミットへの影響を軽減できる。
技術メモ: 既存プロファイルを更新する場合、coversAllItems を省略すると既存値が保持される（デフォルト上書きなし）。意図的に切り替える際は明示的に false → true を指定する。

課題: 配送レート計算アプリの初期セットアップ時に、マーチャントが全商品を手動で配送プロファイルに紐付ける手順が煩雑で、オンボーディング完了率が低かった。
打ち手: アプリインストール直後のセットアップフローで coversAllItems: true のプロファイルを自動作成。マーチャントは商品割り当て操作をせずに設定完了できる。
効果: オンボーディングのステップ数を削減し、設定完了率と初期体験の質を向上。サポート問い合わせ（「なぜこの商品に送料が出ないのか」）も減少が見込める。
技術メモ: 本フィールドはアプリが所有する配送プロファイル（app-owned）専用。マーチャントが管理する配送プロファイル、および非配送プロファイルには対応していない点に注意。

TECHNICAL DETAILS