Query Service API指南

此開發人員指南提供在Adobe Experience Platform Query Service API中執行各種作業的步驟。

快速入門

本指南需要您實際瞭解使用Query Service所涉及的各種Adobe Experience Platform服務。

  • Query Service:提供在Experience Platform中查詢資料集並擷取結果查詢作為新資料集的功能。
  • Experience Data Model (XDM) System: Experience Platform用來組織客戶體驗資料的標準化架構。
  • Sandboxes: Experience Platform提供的虛擬沙箱可將單一Platform執行個體分割成個別的虛擬環境,以利開發及改進數位體驗應用程式。

下列章節提供您需瞭解的其他資訊,才能使用API成功使用Query Service。

讀取範例 API 呼叫

本指南提供範例 API 呼叫,示範如何格式化您的請求。 這些包括路徑、必要的標頭和正確格式化的請求承載。 此外,也提供 API 回應中傳回的範例 JSON。 如需本檔案中用於範例API呼叫之慣例的相關資訊,請參閱Experience Platform疑難排解指南中如何讀取範例API呼叫的相關章節。

收集所需標頭的值

若要呼叫Experience Platform API,您必須先完成驗證教學課程。 完成驗證教學課程會提供所有 Platform API 呼叫中每個必要標頭的值,如下所示:

  • 授權: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {ORG_ID}

Experience Platform中的所有資源都與特定的虛擬沙箱隔離。 對Platform API的所有請求都需要一個標頭,以指定將執行操作的沙箱名稱:

  • x-sandbox-name: {SANDBOX_NAME}
NOTE
如需在Experience Platform中使用沙箱的詳細資訊,請參閱沙箱概觀檔案

API呼叫範例

現在您已瞭解要使用哪些標頭,您已準備好開始呼叫Query Service API。 下列檔案會逐步說明您可以使用Query Service API進行的各種API呼叫。 每個呼叫範例都包含一般API格式、顯示必要標題的範例要求以及範例回應。

後續步驟

現在您已瞭解如何使用Query Service API進行呼叫,您可以建立自己的非互動式查詢。 如需有關如何建立查詢的詳細資訊,請參閱SQL參考指南

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb