文件AEM Content AI

設定 Adobe Developer Console 專案 configure-adc-project

最後更新： 2026年6月4日

建立對象：

  • Beginner
  • Developer
  • Admin

若要呼叫 AEM Content AI 服務 API，您需要由 Adobe Developer Console (ADC) 專案核發的認證。 此頁面會逐步引導您建立專案、選取驗證方法，以及產生您隨每個 API 請求包含的認證。

前往 Adobe Developer Console 讓您的組織開始。

先決條件 prerequisites

在開始之前，請確保已滿足以下條件：

  • 您擁有您的組織之 Adobe Developer Console 存取權。
  • 您在 Adobe Admin Console 的 AEM Content AI 服務產品設定檔中被新增為​開發人員。 若沒有此角色，AEM Content AI 服務 API 卡片會顯示為停用，且​ 伺服器對伺服器 ​驗證選項會隱藏。
  • 您知道要選取之產品設定檔的程式和環境編號 (例如 AEM User - publish - Program 12345 - Environment 67890)。
  • 您在 Admin Console 中擁有該程式的​ 系統管理員 ​角色。 此角色可讓您管理產品設定檔並將使用者指派給環境。

選擇驗證方法 choose-auth

AEM Content AI 服務支援兩種驗證方法。 挑選符合您整合要求的方法：

方法
最適合
伺服器對伺服器
無需使用者互動即可呼叫 API 的後端服務。 傳回短期存取權杖。
API 金鑰
直接呼叫 API 的用戶端或瀏覽器式整合。 傳回範圍設定為允許網域的長期金鑰。

伺服器對伺服器驗證 s2s-auth

  1. 選取 API 和服務，然後選取 API。

    顯示 API 和服務的 Developer Console

  2. 依​ AEM Content AI 服務 ​篩選，然後選取​ 建立專案 ​以開始新專案，或如果您要將服務新增至現有專案，則選取​新增 API。

    note
    NOTE
    如果 API 卡片停用並出現「需要授權」訊息，您的 AEM as a Cloud Service 環境可能無法現代化。 請參閱 AEM as a Cloud Service 環境的現代化。

  3. 在「設定 API」對話框中，選取​ 伺服器對伺服器 ​驗證。

    已選取伺服器對伺服器設定 API 對話框

    note tip
    TIP
    如果伺服器對伺服器選項無法使用，則設定整合的使用者不會以開發人員身分新增至產品設定檔。 請參閱啟用伺服器對伺服器驗證。

  4. 如有需要，請重新命名認證。 選取​「下一步」。

    Adobe Developer Console 步驟，在選取「下一步」之前，重新命名新的伺服器對伺服器認證

  5. 選取「AEM 使用者 - 發佈 - 程式 XXX - 環境 XXX」和/或「AEM使用者 - 作者 - 程式 XXX - 環境 XXX」產品設定檔，然後選取「儲存」。

    產品設定檔選擇器，顯示目標程式和環境的 AEM 使用者發佈和作者設定檔

  6. 審閱 API 和驗證設定。

    審閱畫面摘要列出選取的 API、驗證類別和認證名稱

    審閱畫面詳細資料，顯示認證的指派產品設定檔

產生存取權杖 generate-token

  1. 在您的 ADC 專案中，前往「認證」並選取「產生存取權杖」。

    認證頁面中的「產生存取權杖」按鈕醒目提示

  2. 在每個 API 請求的 Authorization 標頭中包含權杖：

    code language-http 
    Authorization: Bearer YOUR_ACCESS_TOKEN
    note warning
    WARNING
    安全地儲存權杖。 權杖過期，必須定期重新產生。

API 金鑰驗證 api-key-auth

  1. 將 AEM Content AI 服務 API 新增至專案時，請在「選取驗證類別」對話框中選取「API 金鑰」。

    選取 API 驗證類型

  2. 確認 API 金鑰認證。

    新增 API 金鑰認證

  3. 若要限制可以使用金鑰的來源，請設定允許的網域。

    設定允許的網域

  4. 您的 API 金鑰 (用戶端 ID) 會顯示在​ 已連線的認證 ​下。 選取「複製」。

    從連線的認證複製 API 金鑰

  5. 在每個 API 要求中納入金鑰：

    code language-http 
    x-api-key: YOUR_API_KEY

    您的專案現已準備就緒。 將金鑰用於對 AEM Content AI 服務的每個請求。

後續步驟 next-steps

recommendation-more-help
experience-manager-content-ai-help-content-ai