開始使用Policy Service API
Policy Service API可讓您建立和管理與Adobe Experience Platform資料控管相關的各種資源。 本檔案提供嘗試呼叫Policy Service API之前需要瞭解的核心概念簡介。
先決條件
使用開發人員指南需要實際瞭解與使用資料控管功能有關的各種Experience Platform服務。 開始使用Policy Service API之前,請檢閱下列服務的檔案:
- 資料控管: Experience Platform強制資料使用規範所依據的架構。
- Experience Data Model (XDM) System: Experience Platform用來組織客戶體驗資料的標準化架構。
- Real-Time Customer Profile:根據來自多個來源的彙總資料,提供統一的即時消費者設定檔。
- 沙箱: Experience Platform提供可將單一Platform執行個體分割成個別虛擬環境的虛擬沙箱,以利開發及改進數位體驗應用程式。
讀取範例 API 呼叫
Policy Service API檔案提供範例API呼叫,示範如何格式化您的請求。 這些包括路徑、必要的標頭和正確格式化的請求承載。 此外,也提供 API 回應中傳回的範例 JSON。 如需檔案中所使用範例API呼叫慣例的詳細資訊,請參閱Experience Platform疑難排解指南中如何讀取範例API呼叫一節。
必要的標頭
API檔案也要求您完成驗證教學課程,才能成功呼叫Platform端點。 完成驗證教學課程會提供Experience Platform API呼叫中每個必要標題的值,如下所示:
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
Experience Platform中的所有資源(包括屬於資料控管的資源)都與特定的虛擬沙箱隔離。 對Platform API的所有請求都需要標頭,以指定將在其中執行作業的沙箱名稱:
x-sandbox-name: {SANDBOX_NAME}
所有包含承載 (POST、PUT、PATCH) 的請求都需有額外的標頭:
Content-Type: application/json
核心與自訂資源
在Policy Service API中,所有原則和行銷動作都稱為core
或custom
資源。
core
資源是由Adobe定義及維護的資源,而custom
資源是由您的組織建立及維護的資源,因此是唯一的且僅對您的組織可見。 因此,清單和查詢作業(GET
)是唯一允許在core
資源上執行的作業,而清單、查詢和更新作業(POST
、PUT
、PATCH
和DELETE
)則適用於custom
資源。
後續步驟
若要開始使用原則服務API進行呼叫,請選取其中一個可用的端點指南。