文件Experience PlatformData Ingestion 指南

批次內嵌開發人員指南

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

建立對象：

  • 開發人員

本檔案提供在Adobe Experience Platform中使用批次擷取API端點的完整指南。 如需批次擷取API的概觀，包括必要條件和最佳實務，請先閱讀批次擷取API概觀。

本檔案的附錄提供格式化要用於內嵌的資料的資訊，包括範例CSV和JSON資料檔案。

快速入門

本指南中使用的API端點是批次擷取API的一部分。 批次內嵌是透過RESTful API提供，您可在此針對支援的物件型別執行基本CRUD作業。

在繼續之前，請檢閱批次擷取API總覽和快速入門手冊。

擷取JSON檔案

NOTE
下列步驟適用於小型檔案（256 MB或更小）。 如果您遇到閘道逾時或請求內文大小錯誤，您必須切換到大型檔案上傳。

建立批次

首先，您需要建立批次，以JSON作為輸入格式。 建立批次時，您需要提供資料集ID。 您也必須確保批次中上傳的所有檔案都符合連結至所提供資料集的XDM結構。

NOTE
以下範例適用於單行JSON。 若要內嵌多行JSON，需要設定isMultiLineJson標幟。 如需詳細資訊，請參閱批次擷取疑難排解指南。

API格式

POST /batches

要求

curl -X POST https://platform.adobe.io/data/foundation/import/batches \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
          "datasetId": "{DATASET_ID}",
           "inputFormat": {
                "format": "json"
           }
      }'
參數
說明
{DATASET_ID}
參考資料集的ID。

回應

{
    "id": "{BATCH_ID}",
    "imsOrg": "{ORG_ID}",
    "updated": 0,
    "status": "loading",
    "created": 0,
    "relatedObjects": [
        {
            "type": "dataSet",
            "id": "{DATASET_ID}"
        }
    ],
    "version": "1.0.0",
    "tags": {},
    "createdUser": "{USER_ID}",
    "updatedUser": "{USER_ID}"
}
參數
說明
{BATCH_ID}
新建立批次的ID。
{DATASET_ID}
參考資料集的ID。

上傳檔案

現在您已建立批次，可以使用批次建立回應中的批次ID將檔案上傳到批次。 您可以將多個檔案上傳到批次中。

NOTE
請參閱附錄一節，以取得正確格式化的JSON資料檔🔗的範例。

API格式

PUT /batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}
參數
說明
{BATCH_ID}
您要上傳之批次的ID。
{DATASET_ID}
批次參考資料集的ID。
{FILE_NAME}
您要上傳的檔案名稱。 請確定您使用唯一的檔案名稱，這樣它就不會與要提交之批次檔案的其他檔案衝突。

要求

NOTE
API支援單一部分上傳。 確保內容型別是application/octet-stream。
curl -X PUT https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}.json \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'content-type: application/octet-stream' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  --data-binary "@{FILE_PATH_AND_NAME}.json"
參數
說明
{FILE_PATH_AND_NAME}
您嘗試上傳之檔案的完整路徑和名稱。 此檔案路徑是本機檔案路徑，例如acme/customers/campaigns/summer.json。

回應

200 OK

完成批次

上傳完檔案的所有不同部分後，您需要指出資料已完全上傳，且批次已準備好進行升級。

API格式

POST /batches/{BATCH_ID}?action=COMPLETE
參數
說明
{BATCH_ID}
您要上傳之批次的ID。

要求

curl -X POST "https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}?action=COMPLETE" \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

回應

200 OK

擷取Parquet檔案 ingest-parquet-files

NOTE
下列步驟適用於小型檔案（256 MB或更小）。 如果您遇到閘道逾時或請求內文大小錯誤，您將需要切換到大型檔案上傳。

建立批次

首先，您需要建立批次，以Parquet作為輸入格式。 建立批次時，您需要提供資料集ID。 您也必須確保批次中上傳的所有檔案都符合連結至所提供資料集的XDM結構。

要求

curl -X POST "https://platform.adobe.io/data/foundation/import/batches" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -H "x-gw-ims-org-id: {ORG_ID}" \
  -H "x-api-key: {API_KEY}" \
  -H "x-sandbox-name: {SANDBOX_NAME}"
  -d '{
          "datasetId": "{DATASET_ID}",
           "inputFormat": {
                "format": "parquet"
           }
      }'
參數
說明
{DATASET_ID}
參考資料集的ID。

回應

201 Created

{
    "id": "{BATCH_ID}",
    "imsOrg": "{ORG_ID}",
    "updated": 0,
    "status": "loading",
    "created": 0,
    "relatedObjects": [
        {
            "type": "dataSet",
            "id": "{DATASET_ID}"
        }
    ],
    "version": "1.0.0",
    "tags": {},
    "createdUser": "{USER_ID}",
    "updatedUser": "{USER_ID}"
}
參數
說明
{BATCH_ID}
新建立批次的ID。
{DATASET_ID}
參考資料集的ID。
{USER_ID}
建立批次的使用者ID。

上傳檔案

現在您已建立批次，可以使用之前的batchId將檔案上傳到批次。 您可以將多個檔案上傳到批次中。

API格式

PUT /batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}
參數
說明
{BATCH_ID}
您要上傳之批次的ID。
{DATASET_ID}
批次參考資料集的ID。
{FILE_NAME}
您要上傳的檔案名稱。 請確定您使用唯一的檔案名稱，這樣它就不會與要提交之批次檔案的其他檔案衝突。

要求

CAUTION
此API支援單一部分上傳。 確保內容型別是application/octet-stream。
curl -X PUT https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}.parquet \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/octet-stream' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  --data-binary "@{FILE_PATH_AND_NAME}.parquet"
參數
說明
{FILE_PATH_AND_NAME}
您嘗試上傳之檔案的完整路徑和名稱。 此檔案路徑是本機檔案路徑，例如acme/customers/campaigns/summer.parquet。

回應

200 OK

完成批次

上傳完檔案的所有不同部分後，您需要指出資料已完全上傳，且批次已準備好進行升級。

API格式

POST /batches/{BATCH_ID}?action=complete
參數
說明
{BATCH_ID}
您要訊號之批次的ID已準備好完成。

要求

curl -X POST https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}?action=COMPLETE \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

回應

200 OK

擷取大型Parquet檔案

NOTE
本節詳細說明如何上傳大於256 MB的檔案。 大型檔案會以區塊上傳，然後透過API訊號拼接。

建立批次

首先，您需要建立批次，以Parquet作為輸入格式。 建立批次時，您需要提供資料集ID。 您也必須確保批次中上傳的所有檔案都符合連結至所提供資料集的XDM結構。

API格式

POST /batches

要求

curl -X POST https://platform.adobe.io/data/foundation/import/batches \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'
  -d '{
          "datasetId": "{DATASET_ID}",
           "inputFormat": {
             "format": "parquet"
           }
      }'
參數
說明
{DATASET_ID}
參考資料集的ID。

回應

201 Created

{
    "id": "{BATCH_ID}",
    "imsOrg": "{ORG_ID}",
    "updated": 0,
    "status": "loading",
    "created": 0,
    "relatedObjects": [
        {
            "type": "dataSet",
            "id": "{DATASET_ID}"
        }
    ],
    "version": "1.0.0",
    "tags": {},
    "createdUser": "{USER_ID}",
    "updatedUser": "{USER_ID}"
}
參數
說明
{BATCH_ID}
新建立批次的ID。
{DATASET_ID}
參考資料集的ID。
{USER_ID}
建立批次的使用者ID。

初始化大型檔案

建立批次後，您必須先初始化大型檔案，才能將區塊上傳至批次。

API格式

POST /batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}
參數
說明
{BATCH_ID}
新建立批次的ID。
{DATASET_ID}
參考資料集的ID。
{FILE_NAME}
即將初始化的檔案名稱。

要求

curl -X POST https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}.parquet?action=INITIALIZE \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

回應

201 Created

上傳大型檔案區塊

現在檔案已建立，您可以透過進行重複的PATCH請求（檔案的每個區段各一個）來上傳所有後續區塊。

API格式

PATCH /batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}
參數
說明
{BATCH_ID}
您要上傳之批次的ID。
{DATASET_ID}
批次參考資料集的ID。
{FILE_NAME}
您要上傳的檔案名稱。 請確定您使用唯一的檔案名稱，這樣它就不會與要提交之批次檔案的其他檔案衝突。

要求

CAUTION
此API支援單一部分上傳。 確保內容型別是application/octet-stream。
curl -X PATCH https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}.parquet \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/octet-stream' \
  -H 'Content-Range: bytes {CONTENT_RANGE}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  --data-binary "@{FILE_PATH_AND_NAME}.parquet"
參數
說明
{CONTENT_RANGE}
以整數表示請求範圍的開始和結束。
{FILE_PATH_AND_NAME}
您嘗試上傳之檔案的完整路徑和名稱。 此檔案路徑是本機檔案路徑，例如acme/customers/campaigns/summer.json。

回應

200 OK

完成大型檔案

現在您已建立批次，可以使用之前的batchId將檔案上傳到批次。 您可以將多個檔案上傳到批次中。

API格式

POST /batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}
參數
說明
{BATCH_ID}
要表示完成的批次ID。
{DATASET_ID}
批次參考資料集的ID。
{FILE_NAME}
要表示完成的檔案名稱。

要求

curl -X POST https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}.parquet?action=COMPLETE \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

回應

201 Created

完成批次

上傳完檔案的所有不同部分後，您需要指出資料已完全上傳，且批次已準備好進行升級。

API格式

POST /batches/{BATCH_ID}?action=COMPLETE
參數
說明
{BATCH_ID}
您要訊號為完成的批次ID。

要求

curl -X POST https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}?action=COMPLETE \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

回應

200 OK

擷取CSV檔案

若要內嵌CSV檔案，您需要建立支援CSV的類別、結構描述和資料集。 如需有關如何建立必要類別和結構描述的詳細資訊，請依照臨機結構描述建立教學課程中提供的指示操作。

NOTE
下列步驟適用於小型檔案（256 MB或更小）。 如果您遇到閘道逾時或請求內文大小錯誤，您將需要切換到大型檔案上傳。

建立資料集

依照上述指示建立必要的類別和結構描述後，您需要建立可支援CSV的資料集。

API格式

POST /catalog/dataSets

要求

curl -X POST https://platform.adobe.io/data/foundation/catalog/dataSets \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'
  -d '{
      "name": "{DATASET_NAME}",
      "schemaRef": {
          "id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
          "contentType": "application/vnd.adobe.xed+json;version=1"
      }
  }'
參數
說明
{TENANT_ID}
此ID可用來確保您建立的資源能正確進行名稱空間，並包含在您的組織內。
{SCHEMA_ID}
您已建立的結構描述ID。

建立批次

接下來，您需要以CSV作為輸入格式建立批次。 建立批次時，您需要提供資料集ID。 您也必須確保批次中上傳的所有檔案都與連結至所提供資料集的結構描述相符。

API格式

POST /batches

要求

curl -X POST https://platform.adobe.io/data/foundation/import/batches \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'
  -d '{
            "datasetId": "{DATASET_ID}",
            "inputFormat": {
                "format": "csv"
            }
      }'
參數
說明
{DATASET_ID}
參考資料集的ID。

回應

201 Created

{
    "id": "{BATCH_ID}",
    "imsOrg": "{ORG_ID}",
    "updated": 0,
    "status": "loading",
    "created": 0,
    "relatedObjects": [
        {
            "type": "dataSet",
            "id": "{DATASET_ID}"
        }
    ],
    "version": "1.0.0",
    "tags": {},
    "createdUser": "{USER_ID}",
    "updatedUser": "{USER_ID}"
}
參數
說明
{BATCH_ID}
新建立批次的ID。
{DATASET_ID}
參考資料集的ID。
{USER_ID}
建立批次的使用者ID。

上傳檔案

現在您已建立批次，可以使用之前的batchId將檔案上傳到批次。 您可以將多個檔案上傳到批次中。

NOTE
請參閱附錄一節，以取得正確格式化的CSV資料檔範例。

API格式

PUT /batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}
參數
說明
{BATCH_ID}
您要上傳之批次的ID。
{DATASET_ID}
批次參考資料集的ID。
{FILE_NAME}
您要上傳的檔案名稱。 請確定您使用唯一的檔案名稱，這樣它就不會與要提交之批次檔案的其他檔案衝突。

要求

CAUTION
此API支援單一部分上傳。 確保內容型別是application/octet-stream。
curl -X PUT https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}.csv \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/octet-stream' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  --data-binary "@{FILE_PATH_AND_NAME}.csv"
參數
說明
{FILE_PATH_AND_NAME}
您嘗試上傳之檔案的完整路徑和名稱。 此檔案路徑是本機檔案路徑，例如acme/customers/campaigns/summer.csv。

回應

200 OK

完成批次

上傳完檔案的所有不同部分後，您需要指出資料已完全上傳，且批次已準備好進行升級。

API格式

POST /batches/{BATCH_ID}?action=COMPLETE

要求

curl -X POST https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}?action=COMPLETE \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

回應

200 OK

取消批次

批次處理期間，仍可取消。 不過，一旦批次完成（例如成功或失敗狀態），就無法取消批次。

API格式

POST /batches/{BATCH_ID}?action=ABORT
參數
說明
{BATCH_ID}
您要取消的批次識別碼。

要求

curl -X POST https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}?action=ABORT \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

回應

200 OK

刪除批次 delete-a-batch

若要刪除批次，請以您要刪除之批次的ID的action=REVERT查詢引數執行下列POST請求。 該批次被標籤為「非使用中」，因此符合記憶體回收的資格。 系統會以非同步方式收集批次，然後將收集到的批次標示為「已刪除」。

API格式

POST /batches/{BATCH_ID}?action=REVERT
參數
說明
{BATCH_ID}
您要刪除之批次的ID。

要求

curl -X POST https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}?action=REVERT \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

回應

200 OK

修補批次

有時候，您可能需要更新組織設定檔存放區中的資料。 例如，您可能需要更正記錄或變更屬性值。 Adobe Experience Platform支援透過更新插入動作或「修補批次」來更新或修補設定檔存放區資料。

NOTE
這些更新僅允許在設定檔記錄上進行，不允許在體驗事件上進行。

若要修補批次，需要下列專案：

  • 已啟用設定檔和屬性更新的資料集。 ​這是透過資料集標籤完成的，並需要將特定的isUpsert:true標籤新增到unifiedProfile陣列。 如需詳細步驟，說明如何建立資料集或設定現有資料集以進行更新插入，請遵循啟用資料集以進行設定檔更新的教學課程。
  • 包含要修補的欄位和設定檔識別欄位的Parquet檔案。 ​修補批次的資料格式與一般批次擷取程式類似。 需要的輸入是Parquet檔案，除了要更新的欄位之外，上傳的資料必須包含身分欄位，以便與設定檔存放區中的資料相符。

一旦您啟用了設定檔和upsert的資料集，以及包含您要修補的欄位以及必要的身分欄位的Parquet檔案，您可以依照擷取Parquet檔案的步驟，透過批次擷取完成修補。

重播批次

如果您想要取代已擷取的批次，可以使用「批次重播」來執行此操作，此動作等同於刪除舊批次並擷取新批次。

建立批次

首先，您需要建立批次，以JSON作為輸入格式。 建立批次時，您需要提供資料集ID。 您也必須確保批次中上傳的所有檔案都符合連結至所提供資料集的XDM結構。 此外，您還需要在重播區段中提供舊批次作為參考。 在下列範例中，您正在重播識別碼為batchIdA和batchIdB的批次。

API格式

POST /batches

要求

curl -X POST https://platform.adobe.io/data/foundation/import/batches \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'
  -d '{
          "datasetId": "{DATASET_ID}",
           "inputFormat": {
             "format": "json"
           },
            "replay": {
                "predecessors": ["${batchIdA}","${batchIdB}"],
                "reason": "replace"
             }
      }'
參數
說明
{DATASET_ID}
參考資料集的ID。

回應

201 Created

{
    "id": "{BATCH_ID}",
    "imsOrg": "{ORG_ID}",
    "updated": 0,
    "status": "loading",
    "created": 0,
    "relatedObjects": [
        {
            "type": "dataSet",
            "id": "{DATASET_ID}"
        }
    ],
    "replay": {
        "predecessors": [
            "batchIdA", "batchIdB"
        ],
        "reason": "replace"
    },
    "version": "1.0.0",
    "tags": {},
    "createdUser": "{USER_ID}",
    "updatedUser": "{USER_ID}"
}
參數
說明
{BATCH_ID}
新建立批次的ID。
{DATASET_ID}
參考資料集的ID。
{USER_ID}
建立批次的使用者ID。

上傳檔案

現在您已建立批次，可以使用之前的batchId將檔案上傳到批次。 您可以將多個檔案上傳到批次中。

API格式

PUT /batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}
參數
說明
{BATCH_ID}
您要上傳之批次的ID。
{DATASET_ID}
批次參考資料集的ID。
{FILE_NAME}
您要上傳的檔案名稱。 請確定您使用唯一的檔案名稱，這樣它就不會與要提交之批次檔案的其他檔案衝突。

要求

CAUTION
此API支援單一部分上傳。 確保內容型別是application/octet-stream。 請勿使用curl -F選項，因為該選項預設為與API不相容的多部分請求。
curl -X PUT https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}.json \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/octet-stream' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  --data-binary "@{FILE_PATH_AND_NAME}.json"
參數
說明
{FILE_PATH_AND_NAME}
您嘗試上傳之檔案的完整路徑和名稱。 此檔案路徑是本機檔案路徑，例如acme/customers/campaigns/summer.json。

回應

200 OK

完成批次

上傳完檔案的所有不同部分後，您需要指出資料已完全上傳，且批次已準備好進行升級。

API格式

POST /batches/{BATCH_ID}?action=COMPLETE
參數
說明
{BATCH_ID}
您要完成的批次識別碼。

要求

curl -X POST https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}?action=COMPLETE \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

回應

200 OK

附錄

下節包含使用批次擷取在Experience Platform中擷取資料的其他資訊。

批次擷取的資料轉換

為了將資料檔案擷取到Experience Platform，該檔案的階層結構必須符合與要上傳到的資料集相關聯的體驗資料模型(XDM)結構描述。

有關如何對應CSV檔案以符合XDM結構描述的資訊，請參閱範例轉換檔案，以及正確格式化的JSON資料檔案範例。 您可以在此處找到檔案中提供的範例檔案：

recommendation-more-help
2ee14710-6ba4-4feb-9f79-0aad73102a9a