ドキュメントCommerceCatalog Service ガイド

Catalog Serviceの基本を学ぶ

Last update: Thu May 07 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 管理者
  • 開発者

Catalog Serviceを有効にした後、サービスにアクセスし、それを使用してAdobe Commerce インスタンスから商品やカテゴリ情報などのカタログデータを取得できます。 このサービスは、GraphQL APIとして利用でき、Commerce管理者またはGraphQL クエリをサポートするあらゆるフロントエンドアプリケーションからアクセスできます。

NOTE
Adobe Commerce OptimizerまたはAdobe Commerce Optimizer コネクタを使用するCommerce ソリューションの場合は、Catalog Service GraphQL APIの代わりにMerchandising Services GraphQL APIを使用します。

サービスへのアクセス

Catalog ServiceはGraphQL APIとして利用でき、Commerce管理者またはGraphQL クエリをサポートするあらゆるフロントエンドアプリケーションからアクセスできます。 このサービスは、SaaS環境とPaaS環境の両方で利用できます。

[PaaSのみ]{class="badge informative" title="Adobe Commerce on Cloud プロジェクト（Adobeで管理されるPaaS インフラストラクチャ）とオンプレミス プロジェクトにのみ適用されます。"}

環境
エンドポイント
テスト
https://catalog-service-sandbox.adobe.io/graphql
本番
https://catalog-service.adobe.io/graphql

[SaaSのみ]{class="badge positive" title="Adobe Commerce as a Cloud ServiceおよびAdobe Commerce Optimizer プロジェクト（Adobeが管理するSaaS インフラストラクチャ）にのみ適用されます。"}

環境
エンドポイント
テスト
https://na1-sandbox.api.commerce.adobe.com/{{tenant-id}}/graphql
実稼動（まだ利用できません）
https://na1.api.commerce.adobe.com/{{tenant-id}}/graphql

SaaS エンドポイントの​URL構造

https://<region>-<environment>.api.commerce.adobe.com/<tenantId>/graphql
  • <region>は、インスタンスがデプロイされるクラウド領域です。
  • <environment>は、sandboxなどの環境タイプです。 環境が実稼動環境の場合、この値は省略されます。
  • <tenantId>は、Adobe Experience Cloud内の組織の特定のインスタンスの一意のIDです。

カタログサービス GraphQL APIの使用について詳しくは、Adobe Commerce Developer ドキュメントのAdobe Commerce向けカタログサービス ガイド ​を参照してください。

ヘッドレスストアフロントやサードパーティサービスとの統合

ヘッドレスストアフロントと統合するには、ストアフロントとCatalog Service間の通信を有効にして製品およびカテゴリーデータを取得できるように、ストアフロント設定を更新する必要があります。

Edge Delivery ServicesでAdobe Commerce ストアフロントを使用している場合は、カタログサービスエンドポイントをストアフロント設定に追加します。 詳しくは、Edge Delivery Services ドキュメント ​を参照してください。

その他の統合については、サービスとバックエンドのデータソース間の統合を設定する方法について詳しくは、プロジェクト設定ドキュメントを参照してください。

ファイアウォール設定

ファイアウォール経由でCatalog Serviceを許可するには、commerce.adobe.ioをファイアウォール許可リストに加えるに追加します。

カタログサービスとAPI メッシュ

Adobe Developer App Builder向けAPI Meshを使用すると、開発者は、Adobe IOを使用して、プライベートまたはサードパーティのAPIやその他のインターフェイスをAdobe製品と統合できます。

インストールと設定の詳細については、Catalog Service およびAPI Meshのトピックを参照してください。

データ書き出しの監視とトラブルシューティング

Commerce管理者は、Commerceから接続されたサービスへのデータ書き出しを監視およびトラブルシューティングするためのツールを提供します。

  • Data Management Dashboard - Catalog ServiceとAdobe Commerce インスタンス間のデータ同期を監視します。 ダッシュボードには、全体的な同期ステータスが表示され、同期済みのすべての製品が一覧表示されます。

  • データフィードの同期ステータス ページ ​ – すべてのデータフィードの書き出しステータスを追跡して、データの一貫性を確保します。 このページでは、書き出しプロセス中に発生した問題を警告し、迅速に解決できるようにします。 「Success」ステータスは、データが書き出され、データの同期プロセスが完了すると、接続されたCommerce サービスで使用可能であることを示します。

NOTE
Data Feed Sync Status ページがCommerce Admin for Commerce on Cloudまたはオンプレミスのデプロイメントで使用できない場合は、拡張機能のインストール手順に従って有効にします。
recommendation-more-help
caa758b0-fff2-4350-a281-16253ff7b81f