在API中建立資料集

要使用Catalog API建立資料集,您必須知道資料集所基於的Experience Data Model (XDM)模式的$id值。 一旦擁有架構ID,您就可以透過對Catalog API中的/datasets端點發出POST請求來建立資料集。

注意

本文檔僅涵蓋如何在Catalog中建立資料集物件。 有關如何建立、填充和監視資料集的完整步驟,請參閱以下教程

API格式

POST /dataSets

要求

下列請求會建立參照先前定義之架構的資料集。

curl -X POST \
  'https://platform.adobe.io/data/foundation/catalog/dataSets?requestDataSource=true' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
    "name":"LoyaltyMembersDataset",
    "schemaRef": {
        "id": "https://ns.adobe.com/{TENANT_ID}/schemas/719c4e19184402c27595e65b931a142b",
        "contentType": "application/vnd.adobe.xed+json;version=1"
    }
}'
屬性 說明
name 要建立的資料集的名稱。
schemaRef.id 資料集將基於的XDM模式的URI $id值。
schemaRef.contentType 指示方案的格式和版本。 如需詳細資訊,請參閱XDM API指南中有關架構版本控制的章節。
注意

此示例使用Apache Parce檔案格式作為其containerFormat屬性。 使用JSON檔案格式的範例,請參閱批次擷取開發人員指南

回應

成功的響應返回HTTP狀態201(已建立)和一個響應對象,該響應對象由一個陣列組成,該陣列包含以"@/datasets/{DATASET_ID}"格式新建立的資料集的ID。 資料集ID是唯讀、系統產生的字串,用於在API呼叫中參考資料集。

[
    "@/dataSets/5c8c3c555033b814b69f947f"
]

本頁內容