开始使用Catalog Service

启用Catalog Service后,您可以访问该服务,并使用它从Adobe Commerce实例中检索目录数据,如产品和类别信息。 该服务作为GraphQL API提供,您可以从Commerce管理员或从支持GraphQL查询的任何前端应用程序访问该服务。

NOTE
对于使用Adobe Commerce Optimizer或Adobe Commerce Optimizer Connector的Commerce解决方案,请使用促销服务GraphQL API,而不是目录服务GraphQL API。

访问服务

Catalog Service可用作GraphQL API,您可以从Commerce管理员或任何支持GraphQL查询的前端应用程序访问它。 该服务在SaaS和PaaS环境中均可用。

[PaaS]{class="badge informative" title="仅适用于云项目(Adobe管理的PaaS基础架构)和内部部署项目上的Adobe Commerce 。"}

环境
端点
正在测试
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中您组织的特定实例的唯一标识符。

有关使用目录服务GraphQL API的详细信息,请参阅​ Adobe Commerce开发人员 ​文档中的Adobe Commerce目录服务指南

与Headless店面或第三方服务集成

要与Headless店面集成,您必须更新店面配置以启用店面和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主题。

监控数据导出并排除其故障

要验证数据同步是否正常工作,请确认已成功从Adobe Commerce导出数据,并且数据已成功传递到连接的Commerce服务。 使用部署中的功能板检查这两个步骤。

从导出开始,然后确认投放。

  1. 在Commerce管理员中检查同步状态。

    转到​System > Data Transfer > Data Feed Sync Status

    带有馈送项状态报告的数据馈送同步状态页面 {width="800" modal="regular"}

    同步运行时,馈送数据显示已成功发送的记录。 选择信息源以查看详细信息或解决同步问题。

  2. 确认数据已传送到“连接的Commerce服务”。

    从Commerce管理员转到​System > Data Transfer > Data Management Dashboard

    数据管理功能板显示连接的Commerce服务中已同步的目录数据 {width="700" modal="regular"}

    验证是否显示预期的产品、价格和属性。

TIP
如果数据同步还有其他问题,请参阅查看日志和疑难解答

必要时使用Commerce CLI手动重新同步馈送。 有关重新同步选项和其他故障排除步骤,请参阅​ SaaS Data Export Guide ​中的Manage synchronization

NOTE
如果“数据馈送同步状态”页面在Commerce on Cloud或本地部署的Commerce Admin中不可用,请按照扩展安装说明启用它。
recommendation-more-help
commerce-help-catalog-service