開始使用Catalog Service

Catalog Service啟用後,您就可以存取此服務,並使用它從您的Adobe Commerce執行個體擷取目錄資料,例如產品和類別資訊。 此服務是以GraphQL API的形式提供,您可以從Commerce Admin或從任何支援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 Admin移至​System > Data Transfer > Data Management Dashboard

    資料管理儀表板顯示已連線之Commerce服務中的同步目錄資料 {width="700" modal="regular"}

    確認已出現預期的產品、價格和屬性。

TIP
如果您有任何其他資料同步問題,請參閱檢閱記錄檔及疑難排解

必要時使用Commerce CLI手動重新同步摘要。 如需重新同步選項及其他疑難排解步驟,請參閱​ SaaS Data Export Guide ​中的Manage synchronization

NOTE
如果雲端或內部部署的Commerce的Commerce Admin中沒有資料摘要同步狀態頁面,請依照擴充功能安裝指示加以啟用。
recommendation-more-help
commerce-help-catalog-service