文件 Experience Platform Privacy Service 指南

驗證並存取 Privacy Service API

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

開發人員

本指南介紹您在嘗試呼叫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登入。接下來，請依照教學課程中概述的步驟，在Developer Console檔案中建立空白專案。

建立新專案後，請選取 新增至專案，然後從下拉式功能表中選擇 API。

從Developer Console中專案詳細資訊頁面的新增至專案下拉式清單中選取的API選項

選取Privacy ServiceAPI select-privacy-service-api

新增API 畫面會出現。選取 Experience Cloud 以縮小可用API清單的範圍，然後在選取 下一步 之前，選取 Privacy ServiceAPI 的卡片。

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

TIP

選取 檢視檔案 選項，在個別瀏覽器視窗中瀏覽至完整的Privacy ServiceAPI參考檔案。

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

IMPORTANT

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

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