Shopify Storefront API: 変更点と対応すべき内容

Shopify Storefront APIは、ヘッドレスストアフロント、モバイルアプリ、AIエージェントなど、あらゆるプラットフォーム上で完全にカスタマイズされたショッピング体験を構築できるパブリックなGraphQL APIです。2026年は過去のどの年よりも急速に進化しており、バージョン2026-04が現在の安定版リリース、2026-07は本日(2026年6月30日)リリース候補版として出荷されており破壊的な変更があり、2024-10バージョンは10月に廃止となるため、チームには5カ月間の移行期間があります。ヘッドレスストアが現在サポートされているバージョンでない場合、すでにカウントダウンが始まっています。

重要なポイント

• 2026-04は現在の安定版Storefront APIバージョンです。2026-07はカートと商品クエリに破壊的な変更がある有効なリリース候補版です。
• 従来の2024-10バージョンは2026年10月に廃止されます。カスタムビルドの修復コストは8,000ドル、対応が遅れた場合は40,000ドルになります。
• バージョン2025-10は@inContextディレクティブにvisitorConsentパラメータを導入し、GDPR/プライバシー同意をチェックアウトURLに直接エンコードできるようにしました。
• 2026-07から、CartはPRODUCT_UNAVAILABLE_IN_BUYER_LOCATIONとDELIVERY_SELECTED_OPTION_NOT_AVAILABLEの警告を発行するため、UIでこれらを購入者に表示できます。
• Storefront MCPのget_cart/update_cartツールはUCP Cart MCPが優先されるため廃止され、古いツールは2026年8月31日までのみメンテナンスされます。

バージョン管理モデル: Shopifyの四半期リリースサイクルの仕組み

ShopifyはStorefront APIを3ヶ月ごと(1月、4月、7月、10月)に新しいバージョンをリリースします。各安定版は、サポート期間中は変更されないことが保証されており、各安定版は最低12ヶ月間サポートされます。つまり、連続する2つのリリース間には少なくとも9ヶ月の重複期間があります。これが移行期間です。

理解すべき3つのトラックタイプがあります。

• 安定版(例: 2026-04)、本番環境で安全、後方互換性が保証されています。
• リリース候補版(例: 2026-07)、新しい安定版と同じ日に公開され、テスト用に利用可能ですが本番環境には推奨されません。
• 不安定版、継続的に更新され、機能の予告なし削除があります。開発/テストのみです。

知っておくべき注意点として、統合がアクセス不可能な(廃止された)バージョンを対象とする場合、Shopifyは自動的にフォールフォワードし、アクセス可能な最も古い安定版を提供します。X-Shopify-API-Versionレスポンスヘッダーが要求内容と異なる場合、これはサポートされていないバージョンから外れており、サイレント破壊的変更のリスクがあることを示しています。

Shopify App Storeに公開されているアプリの場合、リスクはさらに高くなります。アップグレード期限後にサポートされていないリソースを使い続けるアプリは、App Storeからリストから削除され、ユーザーは最低7日間インストールがブロックされます。

APIバージョン比較: 安定版、リリース候補版、不安定版トラック

2026-04(現在の安定版)で実際に変更された内容

Hydrogenスケルトンが2026-04にバンプしました。Hydrogenの設定を2026-01にピン留めしていた場合は、更新が必要です。スケルトンパッケージ(skeleton@2026.4.0)は、Storefront APIとCustomer Account APIコール全体で2026-04を対象としています。

Shopify Functionsのメタオブジェクトアクセス。 2026-04により、Shopify Functionsがメタオブジェクトデータを直接クエリできるようになります。メタオブジェクト定義をランタイムで読み取ることができるFunctionsベースの割引または配信ロジックがある場合、これは現在利用可能です。

JSONメタフィールドの128KB上限。APIバージョン2026-04以降、ShopifyはJSONメタフィールド値を128KBにキャップしています。ストアフロントが大きなJSONメタフィールドを読み取る場合は、バージョンアップグレードがペイロードをサイレントで壊す前に今すぐデータを監査してください。

2026-07の破壊的変更: ヘッドレスビルドが対応すべき内容

Shopifyの2026年夏版(コード名Compass)は65件の製品アップデートをリリースしました。Storefront API 2026-07はカートと商品クエリ構造に破壊的な変更を導入しており、すべてのヘッドレスビルド(Hydrogen、Next.js Commerce、Nuxt、完全カスタム)に影響します。

10月前に注意が必要なのは以下の通りです。

カート警告信号。 2026-07からは、Cartオブジェクトが2つの新しい警告タイプを発行します。

• PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION。カートラインに購入者の場所で利用できない商品が含まれている場合に発火します。影響を受ける各カートラインは独自の警告を返し、targetがカートライインIDに設定されているため、UIの正しいラインにマップバックできます。
• DELIVERY_SELECTED_OPTION_NOT_AVAILABLE。購入者が選択した配信オプションが利用不可になった場合に発火します(例: カート住所変更後)。以前は、システムが購入者に通知せずにサイレントで配信オプションを切り替えていました。これで購入者に再度選択を促すことができます。

メタオブジェクト列挙型の削除。メタオブジェクト定義の廃止されたPRIVATEとPUBLIC_READアクセス制御列挙型は2026-07で削除されます。アプリまたはストアフロントがこれらの列挙値を参照している場合は、リリースが安定版になる前に現在のアクセス制御モデルに更新してください。

割引フィールドの再構成。 2026-07はCartの割引関連フィールドを再構成します。ストアフロントにカスタム割引表示またはクーポンロジックがある場合は、今すぐリリース候補版に対してリファクタリングを開始してください。Hydrogenユーザーはほとんどの構造フィールド名の変更に対してコードモッドを取得します。カスタムフレームワークは独自に対応する必要があり、修復の見積もりはストアフロントの複雑さに応じて8,000ドルから40,000ドルの間です。

2026年10月の期限は厳格です。APIバージョン2024-10は2026年10月に廃止されます。5ヶ月は快適に見えますが、ステージングデプロイ、回帰テスト、カートロジックが通常どのヘッドレススタックでも最も脆弱な部分であるという事実を考えると、そうではありません。今すぐ2026-07リリース候補版に対するテストを開始してください。

@inContext visitorConsentによるプライバシー準拠チェックアウト

これは2025-10に登場し、最近のメモリにおいて最も実用的なStorefront API追加の1つであり続けています。@inContextディレクティブはvisitorConsentパラメータを受け入れるようになり、開発者は購入者の同意設定(分析、設定、マーケティング、データ販売)をカート操作に渡すことができます。

仕組みは簡潔です。次のように同意をcartCreateまたはcartBuyerIdentityUpdate変更にエンコードします。

@inContext(visitorConsent: {
  analytics: true,
  preferences: true,
  marketing: false,
  saleOfData: false
})

同意情報は自動的にエンコードされ、結果のcheckoutUrlに含まれ、チェックアウトプロセス全体でプライバシーコンプライアンスが確保されます。Shopifyはチェックアウト中にURLに追加する_csパラメータを読み取ります。これを削除しないでください。

これはGDPRおよび類似の制度にとって重要です。以前はクッキーバナーからチェックアウトへの同意を伝播する明確な方法がなかったヘッドレスストアフロントは、API自体に組み込まれたファーストパーティメカニズムを備えています。最新のヘッドレスビルドがこれを実装しない理由はありません。

レート制限: 新しいボットとエージェントの現実

ShopifyはStorefront APIとShopify主催のオンラインストアページにアクセスするボットとエージェントに、より厳しいレート制限を適用するようになりました。リクエストに署名していないボットとエージェントは最も厳しい制限の対象になります。より高いレート制限の対象となるには、オペレータはWeb Bot Authを使用してリクエストに署名する必要があります。

正当な商人と開発者にとって、実用的な意味合いは2つあります。

1. Storefront APIエンドポイントにヒットするカスタムクローラー、価格集約商品、またはAIショッピングエージェントを操作している場合は、リクエストに署名するか、スロットリングを予想してください。
2. Storefront MCPインテグレーション(次のセクションを参照)を構築している場合は、エージェントプロファイルが適切に登録されていることを確認して、適切なアクセス層を受け取るようにしてください。

注意として、Storefront APIは正当な購入者リクエストの数にレート制限が適用されておらず、同時実行を管理せずにフラッシュセール中にトラフィックの増加に対応するように設計されています。新しい制限は特に悪意のある、または識別されていないボットトラフィックを対象としています。

エージェントコマース: Storefront APIがUCPとMCPと出会う

これはStorefront APIの役割における2026年の最も構造的に重要なシフトです。APIは、もはや単なるヘッドレス人間向けストアフロントのバックボーンではありません。現在、AIエージェント向けのエントリーポイントです。

ShopifyはGoogleと共同でUniversal Commerce Protocol(UCP)を開発し、AIエージェントがマーチャントと取引する方法のオープンスタンダードにしました。UCPは発見からカート、チェックアウトまでの完全なコマースジャーニーをカバーし、Amazon、Meta、Microsoft、Salesforce、Stripe、Wayfairを含む業界全体で広くサポートされています。

開発者にとって、具体的な実装サーフェスはStorefront MCPサーバーです。各Shopifyストアには独自のMCPエンドポイントがあり、商品検索、カート操作、ポリシーに関する質問を含むストアフロント機能を公開しています。search_catalog、lookup_catalog、get_productツールはUCP仕様に準拠しています。

重要な移行メモ:従来のStorefront MCPカートツール(get_cartとupdate_cart)はUCP Cart MCPが優先されるため廃止されています。廃止予定のツールは2026年8月31日までメンテナンスされます。これは2024-10 APIの廃止と同じ四半期です。2つの移行が同じ秋の期限に集束しています。

ブランド化されたエージェントまたはカスタムAIショッピング体験を構築している場合、アーキテクチャは単純です。

• カタログ検索と商品詳細取得にStorefront MCPを使用してください。
• カート操作(追加、更新、ラインアイテム読み取り)にはUCP Cart MCPを使用してください。
• 支払いハンドオフにはCheckout Kit(または間もなく予定されているCheckout MCP、現在パートナープレビューで利用可能)を使用してください。

カスタムエージェントを構築していないマーチャントの場合、実用的なアクションはより簡単です。Shopify管理画面でAgentic Storefrontsを通じて販売したいAIチャネルをオンにすると、Shopifyがプロトコルの作業を処理します。ChatGPT、Google AI Mode、Perplexity、Microsoft Copilotはすべて単一の管理設定を通じて到達可能です。

認証とアクセストークン: 2027年1月で変わること

2026年APIバージョンサイクル外の1つの項目ですが、Storefront APIインテグレーションに直接影響します。2027年1月1日からは、すべてのパブリックアプリはAdmin APIコールに有効期限付きのオフラインアクセストークンを使用する必要があります。これはAdmin API変更であり、Storefront API変更ではありませんが、多くのインテグレーションが両方を一緒に使用するため、ヘッドレスビルドがバックエンド操作(在庫同期、注文管理、メタフィールド書き込み)に長期有効なAdmin APIトークンに依存している場合は、Storefront APIバージョンアップグレードと並行してその移行を計画する必要があります。

2026年の残りの期間の移行チェックリスト

緊急度順に並べた順序付きアクションリストです。

1. 現在のピン留めバージョンを確認してください。Hydrogenの設定またはGraphQLクエリヘッダーを開きます。2025-07より古いものはすぐに注意が必要です。
2. 2026-07 RCに対してテストしてください。リリース候補版に対してステージング環境をセットアップしてください。カート変更とカスタム割引表示ロジックに焦点を当ててください。
3. @inContextにvisitorConsentを実装してください。ヘッドレスビルドがクッキーバナーからチェックアウトcheckoutUrlにクッキー同意を伝播していない場合は、今すぐ追加してください。APIバージョン2025-10以降が必要です。
4. 廃止されたメタオブジェクト列挙型を置き換えてください。 2026-07が7月1日に安定版になる前にPRIVATEまたはPUBLIC_READの参照を削除してください。
5. Storefront MCPカートツールからUCP Cart MCPに移行してください。期限: 2026年8月31日。
6. 128KBを超えるJSONメタフィールドを監査してください。 2026-04以上にアップグレードする前に必要です。
7. Storefront APIエンドポイントにヒットするボットまたはエージェントを操作している場合は、Web Bot Auth署名を登録してください。

これらの移行を計画または実行するために直接的なサポートが必要な場合は、提供するShopify開発者サービスはバージョンアップグレード、ヘッドレスアーキテクチャレビュー、Storefront APIパフォーマンス監査をカバーしています。