批处理API指南

本文档全面介绍了如何使用批摄取API

本文档的附录提供了用于摄取🔗的格式化数据的信息,包括示例CSV和JSON数据文件。

入门指南

数据摄取提供了一个RESTful API,通过它可以针对支持的对象类型执行基本的CRUD操作。

以下各节提供您需要了解或掌握的其他信息,以便成功调用Batch Ingestion API。

本指南要求对Adobe Experience Platform的以下组件有充分的了解:

  • 批量摄取:允许您将数据作为批处理文件收录到Adobe Experience Platform。
  • Experience Data Model (XDM) 系统:组织客户体验数 Experience Platform 据的标准化框架。
  • Sandboxes: Experience Platform 提供将单个实例分区为单 Platform 独虚拟环境的虚拟沙箱,以帮助开发和发展数字体验应用程序。

读取示例API调用

本指南提供示例API调用,以演示如何设置请求的格式。 这包括路径、必需的标头和格式正确的请求负载。 还提供API响应中返回的示例JSON。 有关示例API调用文档中使用的约定的信息,请参阅Experience Platform疑难解答指南中关于如何读取示例API调用🔗的部分。

收集所需标题的值

要调用Platform API,您必须首先完成身份验证教程。 完成身份验证教程后,将为所有Experience Platform API调用中每个所需标头提供值,如下所示:

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}

Experience Platform中的所有资源都隔离到特定虚拟沙箱。 对Platform API的所有请求都需要一个头,该头指定操作将在中执行的沙箱的名称:

  • x-sandbox-name: {SANDBOX_NAME}
注意

有关Platform中沙箱的详细信息,请参阅沙箱概述文档

包含有效负荷(POST、PUT、PATCH)的请求可能需要额外的Content-Type头。 在呼叫参数中提供特定于每个呼叫的已接受值。

类型

在摄取数据时,了解Experience Data Model (XDM)模式的工作方式非常重要。 有关XDM字段类型如何映射到不同格式的详细信息,请阅读模式注册表开发人员指南

收录数据时有一些灵活性 — 如果某个类型与目标模式中的内容不匹配,则数据将转换为表示的目标类型。 如果无法,则它将使具有TypeCompatibilityException的批失败。

例如,JSON和CSV都没有日期或日期时间类型。 因此,这些值使用ISO 8061格式化字符串(“2018-07-10T15:05:59.000-08:00”)或Unix时间(以毫秒(1531263959000)格式化,并在摄取时转换为目标 XDM类型。

下表显示了收录数据时支持的转换。

入站(行)与目标(列) 字符串 字节 整数 双精度 Date 日期时间 对象 地图
字符串 X X X X X X X X
字节 X X X X X X
X X X X X X
整数 X X X X X X
X X X X X X X X
双精度 X X X X X X
日期 X
日期时间 X
对象 X X
地图 X X
注意

布尔值和数组无法转换为其他类型。

摄取约束

批处理数据获取存在一些限制:

  • 每批文件的最大数量:1500
  • 最大批大小:100 GB
  • 每行的属性或字段的最大数:10000
  • 每位用户每分钟的最大批数:138

收录JSON文件

注意

以下步骤适用于小文件(256 MB或更小)。 如果遇到网关超时或请求正文大小错误,则需要切换到大文件上传。

创建批

首先,您需要创建一个以JSON为输入格式的批。 创建批时,您需要提供数据集ID。 您还需要确保作为批处理的一部分上传的所有文件都符合链接到提供数据集的XDM模式。

注意

以下示例适用于单行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: {IMS_ORG}' \
  -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": "{IMS_ORG}",
    "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。

上载文件

现在您已创建了批,可以使用之前的batchId将文件上传到该批。 您可以将多个文件上传到该批。

注意

有关格式正确的JSON数据文件🔗的示例,请参阅附录部分。

API格式

PUT /batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}
参数 描述
{BATCH_ID} 要上传到的批的ID。
{DATASET_ID} 批的引用数据集的ID。
{FILE_NAME} 要上载的文件的名称。 此文件路径是保存文件的Adobe。

请求

注意

API支持单部分上传。 确保content-type为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: {IMS_ORG}' \
  -H 'x-api-key : {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  --data-binary "@{FILE_PATH_AND_NAME}.json"
参数 描述
{FILE_PATH_AND_NAME} 您尝试上载的文件的完整路径和名称。 此文件路径是本地文件路径,如Users/sample-user/Downloads/sample.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: {IMS_ORG}' \
  -H 'x-api-key : {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

响应

200 OK

收录拼花文件

注意

以下步骤适用于小文件(256 MB或更小)。 如果遇到网关超时或请求正文大小错误,则需要切换到大文件上传。

创建批

首先,您需要创建一个批,并以Parce为输入格式。 创建批时,您需要提供数据集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: {IMS_ORG}" \
  -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": "{IMS_ORG}",
    "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} 要上载的文件的名称。 此文件路径是保存文件的Adobe。

请求

注意

此API支持单部分上传。 确保content-type为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: {IMS_ORG}' \
  -H 'x-api-key : {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  --data-binary "@{FILE_PATH_AND_NAME}.parquet"
参数 描述
{FILE_PATH_AND_NAME} 您尝试上载的文件的完整路径和名称。 此文件路径是本地文件路径,如Users/sample-user/Downloads/sample.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: {IMS_ORG}' \
  -H 'x-api-key : {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' 

响应

200 OK

收录大型镶木文件

注意

本节详细介绍如何上传大于256 MB的文件。 大型文件以块形式上传,然后通过API信号进行拼接。

创建批

首先,您需要创建一个批,并以Parce为输入格式。 创建批时,您需要提供数据集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: {IMS_ORG}' \
  -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": "{IMS_ORG}",
    "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: {IMS_ORG}' \
  -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} 要上载的文件的名称。 此文件路径是保存文件的Adobe。

请求

注意

此API支持单部分上传。 确保content-type为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: {IMS_ORG}' \
  -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} 您尝试上载的文件的完整路径和名称。 此文件路径是本地文件路径,如Users/sample-user/Downloads/sample.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: {IMS_ORG}' \
  -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: {IMS_ORG}' \
  -H 'x-api-key : {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' 

响应

200 OK

收录CSV文件

要收录CSV文件,您需要创建一个支持CSV的类、模式和数据集。 有关如何创建必需类和模式的详细信息,请按照ad-hoc模式创建教程中提供的说明操作。

注意

以下步骤适用于小文件(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: {IMS_ORG}' \
  -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用于确保您创建的资源命名正确且包含在IMS组织中。
{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: {IMS_ORG}' \
  -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": "{IMS_ORG}",
    "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将文件上传到该批。 您可以将多个文件上传到该批。

注意

有关格式正确的CSV数据文件🔗的示例,请参阅附录部分。

API格式

PUT /batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}
参数 描述
{BATCH_ID} 要上传到的批的ID。
{DATASET_ID} 批的引用数据集的ID。
{FILE_NAME} 要上载的文件的名称。 此文件路径是保存文件的Adobe。

请求

注意

此API支持单部分上传。 确保content-type为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: {IMS_ORG}' \
  -H 'x-api-key : {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  --data-binary "@{FILE_PATH_AND_NAME}.csv"
参数 描述
{FILE_PATH_AND_NAME} 您尝试上载的文件的完整路径和名称。 此文件路径是本地文件路径,如Users/sample-user/Downloads/sample.json

响应

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: {IMS_ORG}' \
  -H 'x-api-key : {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

响应

200 OK

取消批

在批处理时,仍可取消批处理。 但是,一旦批完成(如成功或失败状态),便无法取消该批。

API格式

POST /batches/{BATCH_ID}?action=ABORT
参数 描述
{BATCH_ID} 要取消的批的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: {IMS_ORG}' \
  -H 'x-api-key : {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' 

响应

200 OK

删除批处理

可以通过将action=REVERTPOST参数与要删除的批的ID一起执行以下查询请求来删除批。 批被标为“非活动”,因此符合垃圾收集条件。 将异步收集批,此时该批将标记为“已删除”。

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: {IMS_ORG}' \
  -H 'x-api-key : {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' 

响应

200 OK

重放批

如果要替换已摄取的批,可以使用“批重播”进行替换 — 此操作等效于删除旧批,而取代新批。

创建批

首先,您需要创建一个以JSON为输入格式的批。 创建批时,您需要提供数据集ID。 您还需要确保作为批处理的一部分上传的所有文件都符合链接到提供数据集的XDM模式。 此外,您还需要在重放部分中提供旧批作为引用。 在以下示例中,您正在重新播放ID为batchIdAbatchIdB的批。

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: {IMS_ORG}' \
  -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": "{IMS_ORG}",
    "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} 要上载的文件的名称。 此文件路径是保存文件的Adobe。

请求

注意

此API支持单部分上传。 确保content-type为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: {IMS_ORG}' \
  -H 'x-api-key : {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  --data-binary "@{FILE_PATH_AND_NAME}.json"
参数 描述
{FILE_PATH_AND_NAME} 您尝试上载的文件的完整路径和名称。 此文件路径是本地文件路径,如Users/sample-user/Downloads/sample.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: {IMS_ORG}' \
  -H 'x-api-key : {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

响应

200 OK

附录

用于批量摄取的数据转换

要将数据文件引入Experience Platform中,文件的分层结构必须符合与要上载的数据集关联的体验数据模型(XDM)模式。

有关如何映射CSV文件以符合XDM模式的信息,请参阅示例转换文档,以及格式正确的JSON数据文件示例。 文档中提供的示例文件可在以下位置找到:

On this page

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now