[僅限PaaS]{class="badge informative" title="僅適用於雲端專案(Adobe管理的PaaS基礎結構)和內部部署專案的Adobe Commerce 。"}
Commerce Services Connector
部分Adobe Commerce和Magento Open Source功能由Commerce Services提供技術支援，並部署為SaaS （軟體即服務）。 若要使用這些服務，您必須使用生產及沙箱API金鑰連線您的Commerce執行個體，並在設定中指定資料空間。 您只需要為每個執行個體設定一次連線。
只有Commerce授權擁有者可以產生這些API金鑰。 如果您不是授權擁有者，請向擁有您商店的Commerce授權的人員或團隊要求金鑰。
可用的服務 availableservices
以下列出您可以透過Commerce存取的Commerce Services Connector功能：
架構
從高層次來看，Commerce Services Connector由下列核心元素組成：
以下各節會更詳細地討論這些元素。
認證 apikey
從Commerce授權擁有者的帳戶產生生產和沙箱API金鑰。 Commerce帳戶由唯一的Commerce ID (MageID)識別。 只要帳戶處於良好狀態，商家組織的授權擁有者就能為產品推薦或Live Search等服務產生API金鑰。
這些金鑰可在「需知」基礎上與系統整合商或開發團隊分享，後者代表授權持有人管理專案和環境。 已獲授權擁有者授予Shared Access的開發人員，無法代表授權擁有者產生金鑰，即使商家組織出現在他們帳戶的Switch Accounts下拉式清單中。
此外，解決方案整合經銷商有權使用Commerce Services。 如果您是解決方案整合商，Commerce合作夥伴合約的簽署者應該產生API金鑰。
金鑰識別碼 生產 和 沙箱 參考了Commerce Services儲存資料的SaaS資料空間環境(不是您的Adobe Commerce環境)。 您可以在本機、開發、測試和生產Adobe Commerce環境中使用同一組API金鑰，重要的是，您必須針對您設定的資料空間貼上正確的金鑰組。
授權擁有者通常是Adobe Commerce帳戶的主要聯絡人，並不一定與雲端基礎結構專案的Adobe Commerce專案擁有者相同。
產生生產和沙箱API金鑰 genapikey
-
在Commercehttps://account.magento.com登入您的帳戶。
-
在 Magento 標籤下，選取側邊欄上的API入口網站。
-
從 環境 功能表，選取 生產 或沙箱。
-
在 API金鑰 區段中輸入名稱，然後按一下 新增 以開啟對話方塊下載新金鑰。
note warning WARNING 您只能複製或下載私密金鑰一次。 請妥善儲存。 -
按一下 下載 以儲存私密金鑰，然後關閉對話方塊。
-
對每個環境（生產和沙箱）重複上述步驟。
API金鑰區段現在會顯示您的API （公開）金鑰。 當您在與授權相關的任何環境或安裝中選取或建立SaaS專案時，您需要所有四個金鑰（生產金鑰和沙箱金鑰，均為Public+Private）。
SaaS設定 saasenv
Commerce執行個體必須設定有SaaS專案和SaaS資料空間，這樣Commerce Services才能將資料傳送到正確的位置。 SaaS專案會將所有SaaS資料空間分組。 SaaS資料空間用於收集和儲存可讓Commerce Services運作的資料。 某些資料可從Commerce執行個體匯出，而某些資料可從店面的購物者行為收集。 然後，這些資料會持續儲存以保護雲端儲存空間。
針對Product Recommendations和Live Search，SaaS資料空間包含目錄和行為資料。 您可以在Commerce設定中選取執行個體，以將Commerce執行個體指向SaaS資料空間。
如果您在Admin中找不到Live Search設定欄位，請確認您為選取的資料空間輸入了正確的API金鑰組（生產資料空間使用生產金鑰，測試資料空間使用沙箱金鑰）。 如果您設定的索引鍵不正確，在該Adobe Commerce環境中將無法使用SaaS服務（例如Live Search）。
刪除API金鑰 delapikey
在刪除API金鑰之前，請產生並安全地儲存取代金鑰。 更新所有整合以使用新金鑰，並確認相依服務如預期般運作。
如果您在管理面板中看不到 Live Search 設定欄位，請確認您為該環境輸入了正確的SaaS API金鑰。 請將生產SaaS索引鍵用於生產資料空間，並將中繼索引鍵用於中繼資料空間。 如果設定了錯誤的金鑰，您的Adobe Commerce環境中將無法使用SaaS服務（包括Live Search）。
在要移除的API金鑰上，按一下Delete。 出現提示時，請確認永久移除金鑰的操作。
SaaS資料空間布建
所有Adobe Commerce商戶都可以存取每個SaaS專案一個生產資料空間和兩個測試資料空間。
您可以在非生產環境中使用測試資料空間，但避免同時在多個環境中使用相同的資料空間。 如果您想要將測試資料空間移動到不同的環境，請先執行資料清理，然後再在新環境中選取和設定它。
對於具有多個中繼環境的Adobe Commerce Cloud Pro專案，您可以透過提交支援請求，為每個中繼環境請求額外的測試資料空間。 不過，如果您只有一個測試環境，且需要額外的測試資料空間，您有以下選項：
-
請聯絡客戶成功團隊或您指派的客戶成功案例經理，以要求額外的測試環境。
-
提交支援要求以要求額外的測試資料空間，並指明額外資料空間的商業理由。 此請求有待核准。
使用Adobe付款服務的Magento Open Source客戶可能也會要求額外的資料空間。 請在提交支援要求以要求測試資料空間之前，先連絡付款團隊以取得其他資料空間的預先核准。
擁有多個雲端專案或內部部署（即時/生產）安裝的客戶，也可透過提交支援要求，要求每個專案或執行個體的額外生產及測試資料空間。
選取或建立SaaS專案 createsaasenv
若要選取或建立SaaS專案，請向商店的Commerce授權擁有者要求Commerce API金鑰：
-
在 管理員 側邊欄上，前往系統 >服務> Commerce服務聯結器。
如果您沒有看到 Commerce Services Connector 區段，請為所需的Commerce服務Commerce 安裝模組，並確定已安裝
magento/module-services-id套件。 -
在 Sandbox API Keys 和_Production API Keys_區段中，貼上您的金鑰值。
- 私密金鑰必須在金鑰開頭包含
-----BEGIN PRIVATE KEY-----，並在金鑰結尾包含-----END PRIVATE KEY-----。 - 如果您沒有實際金鑰的副本，請向授權擁有者索取，然後將值插入設定中。
請勿貼上從資料庫備份或快照複製而來的金鑰值。 儲存設定時，會套用額外的加密層，金鑰將無法運作。
- 私密金鑰必須在金鑰開頭包含
-
按一下儲存。
任何與您的金鑰相關聯的SaaS專案都會顯示在 SaaS識別碼 區段的 專案 欄位中。
-
如果沒有SaaS專案，請按一下建立專案。 然後在 專案 欄位中，輸入您的SaaS專案名稱。
為避免混淆，請勿使用特定的Commerce服務作為專案名稱（例如，即時搜尋、產品建議或資料連線）。 除非您的授權已布建在多個SaaS專案，否則您可以對多個服務使用相同的SaaS專案。
-
選取資料空間，以用於您Commerce存放區的目前組態。
如果您有要與Commerce服務整合的個別執行個體，請提交支援票證，為每個額外的執行個體請求新的SaaS專案。 「支援」建立SaaS專案後，請使用相同的API金鑰為例項設定整合，並為資料空間選取新的SaaS專案。
若要變更SaaS專案或資料空間的名稱，請按一下其中任何一個專案旁邊的重新命名。 變更名稱不會影響您的服務，因為名稱只是一個標籤，可協助您識別並區分專案和資料空間。
IMS組織（選用） organizationid
若要將您的Adobe Commerce執行個體連結至Adobe Experience Platform，請使用您的Adobe ID登入您的Adobe帳戶。 登入後，與您的Adobe帳戶相關聯的IMS組織會顯示在此區段中。
SaaS資料匯出
當您的Commerce執行個體成功連線至Commerce Services時，SaaS資料匯出程式會將Commerce資料從您的Commerce伺服器匯出至Commerce SaaS Services，以便同步處理至連線的Commerce服務。 在Admin中，您可以使用資料管理儀表板來檢查同步處理狀態。 如需詳細資訊，請參閱SaaS資料匯出指南。