文件 Experience Platform Privacy Service 指南

驗證並存取 Privacy Service API

Last update: Thu Feb 29 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

undefined

本指南介紹您在嘗試呼叫Adobe Experience Platform Privacy Service API之前必須瞭解的核心概念。

先決條件 prerequisites

本指南需要您實際瞭解 Privacy Service 以及它如何讓您管理來自Adobe Experience Cloud應用程式中資料主體（客戶）的存取和刪除請求。

為了建立API的存取認證，您組織內的管理員之前必須設定要在Adobe Admin Console中Privacy Service的產品設定檔。您指派給API整合的產品設定檔決定在存取Privacy Service功能時，該整合具有哪些許可權。請參閱以下指南：管理Privacy Service許可權以取得詳細資訊。

收集所需標頭的值 gather-values-required-headers

為了呼叫Privacy Service API，您必須先收集要用於必要標題的存取認證：

Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}

這些值的產生方式 Adobe Developer Console. 您的 {ORG_ID} 和 {API_KEY} 只需產生一次，且可在未來API呼叫中重複使用。不過，您的 {ACCESS_TOKEN} 是暫時性的，必須每24小時重新產生一次。

以下將詳細介紹產生這些值的步驟。

一次性設定 one-time-setup

前往 Adobe Developer Console 並使用您的Adobe ID登入。接下來，請依照教學課程中概述的步驟進行建立空白專案在開發人員控制檯檔案中。

建立新專案後，選取 新增至專案 並選擇 API 下拉式選單中的。

正在從以下專案選取的API選項新增至專案開發人員控制檯中專案詳細資訊頁面的下拉式清單

選取Privacy ServiceAPI select-privacy-service-api

此 新增API 畫面隨即顯示。選取 Experience Cloud 若要縮小可用API的清單，請選取的卡片 PRIVACY SERVICE API 在選取之前 下一個.

從可用API清單中選取的Privacy ServiceAPI卡

TIP

選取 檢視檔案 可在個別瀏覽器視窗中導覽以完成 Privacy Service API參考檔案.

接著，選取驗證型別以產生存取權杖並存取Privacy ServiceAPI。

IMPORTANT

選取 OAuth伺服器對伺服器 方法，因為這是唯一支援日後使用的方法。此 服務帳戶(JWT) 方法已過時。雖然使用JWT驗證方法的整合功能在2025年1月1日之前將繼續運作，但Adobe強烈建議您在該日期之前將現有整合功能移轉至新的OAuth伺服器對伺服器方法。在區段中取得詳細資訊 [已棄用]{class="badge negative"}產生JSON Web權杖(JWT).

選取Oauth伺服器對伺服器的驗證方法。