このドキュメントでは、 バッチ取得 API エンドポイント Adobe Experience Platform 前提条件やベストプラクティスを含む、バッチ取得 API の概要については、まず バッチ取得 API の概要.
このドキュメントの付録では、CSV 例や JSON データファイル例など、取得に使用するデータの形式設定に関する情報を提供します。
このガイドで使用される API エンドポイントは、 バッチ取得 API. バッチ取り込みは、RESTful API を通じて提供されます。この API では、サポートされるオブジェクトタイプに対して基本的な CRUD 操作を実行できます。
続行する前に、 バッチ取得 API の概要 そして 入門ガイド.
次の手順は、小さいファイル(256MB 以下)に適用されます。ゲートウェイのタイムアウトまたは陸エスト本文のサイズエラーが発生した場合は、大きなファイルのアップロードに切り替える必要があります。
まず、JSON を入力形式としてバッチを作成する必要があります。バッチを作成する場合は、データセット ID を指定する必要があります。また、バッチの一部としてアップロードされるすべてのファイルが、提供されたデータセットにリンクされた XDM スキーマに適合していることを確認する必要があります。
以下に、1 行の 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 を使用して、ファイルをバッチにアップロードできます。 複数のファイルをバッチにアップロードできます。
付録の適切に書式設定された JSON データファイルの例についての節を参照してください。
API 形式
PUT /batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}
パラメーター | 説明 |
---|---|
{BATCH_ID} |
アップロード先のバッチの ID。 |
{DATASET_ID} |
バッチの参照データセットの ID。 |
{FILE_NAME} |
アップロードするファイルの名前。送信されるファイルのバッチに対して別のファイルと干渉しないように、一意のファイル名を使用してください。 |
リクエスト
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: {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
次の手順は、小さいファイル(256MB 以下)に適用されます。ゲートウェイのタイムアウトまたは陸エスト本文のサイズエラーが発生した場合は、大きなファイルのアップロードに切り替える必要があります。
まず、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} |
アップロードするファイルの名前。送信されるファイルのバッチに対して別のファイルと干渉しないように、一意のファイル名を使用してください。 |
リクエスト
この 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: {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
この節では、256MB を超えるファイルをアップロードする方法について説明します。大きなファイルはチャンク単位でアップロードされ、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
ファイルが作成されたので、以降のすべてのチャンクは、ファイルの各セクションに対して 1 つずつ、繰り返し PATCH リクエストを実行することでアップロードできます。
API 形式
PATCH /batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}
パラメーター | 説明 |
---|---|
{BATCH_ID} |
アップロード先のバッチの ID。 |
{DATASET_ID} |
バッチの参照データセットの ID。 |
{FILE_NAME} |
アップロードするファイルの名前。送信されるファイルのバッチに対して別のファイルと干渉しないように、一意のファイル名を使用してください。 |
リクエスト
この 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: {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 をサポートするクラス、スキーマ、データセットを作成する必要があります。必要なクラスとスキーマの作成方法について詳しくは、『アドホックスキーマの作成チュートリアル』の手順に従ってください。
次の手順は、小さいファイル(256MB 以下)に適用されます。ゲートウェイのタイムアウトまたは陸エスト本文のサイズエラーが発生した場合は、大きなファイルのアップロードに切り替える必要があります。
上記の手順に従って必要なクラスとスキーマを作成した後、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
を使用してファイルをバッチにアップロードできます。複数のファイルをバッチにアップロードできます。
付録の適切に書式設定された CSV データファイルの例についての節を参照してください。
API 形式
PUT /batches/{BATCH_ID}/datasets/{DATASET_ID}/files/{FILE_NAME}
パラメーター | 説明 |
---|---|
{BATCH_ID} |
アップロード先のバッチの ID。 |
{DATASET_ID} |
バッチの参照データセットの ID。 |
{FILE_NAME} |
アップロードするファイルの名前。送信されるファイルのバッチに対して別のファイルと干渉しないように、一意のファイル名を使用してください。 |
リクエスト
この 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: {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} |
キャンセルするバッチの 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
action=REVERT
クエリパラメーターを使用して、削除するバッチの ID に対して次の 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は、アップサートアクションまたは「バッチのパッチ適用」を通じて、プロファイルストアデータの更新またはパッチをサポートします。
これらの更新は、エクスペリエンスイベントではなく、プロファイルレコードでのみ許可されます。
バッチにパッチを適用するには、次が必要です。
isUpsert:true
タグを unifiedProfile
配列。 データセットを作成する方法、またはアップサート用に既存のデータセットを設定する方法の詳細については、 プロファイル更新用のデータセットの有効化.プロファイルとアップサートを有効にし、パッチを適用するフィールドと必要な ID フィールドを含む Parquet ファイルを作成したら、次の手順に従います。 Parquet ファイルの取得 バッチ取得を使用してパッチを完了するため。
既に取得したバッチを置き換える場合は、「バッチ再生」を使用できます。この操作は、古いバッチを削除し、代わりに新しいバッチを取得する操作と同じです。
まず、JSON を入力形式としてバッチを作成する必要があります。バッチを作成する場合は、データセット ID を指定する必要があります。また、バッチの一部としてアップロードされるすべてのファイルが、提供されたデータセットにリンクされた XDM スキーマに適合していることを確認する必要があります。また、再生セクションで参照として古いバッチを指定する必要があります。次の例では、batchIdA
ID と batchIdB
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": "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} |
アップロードするファイルの名前。送信されるファイルのバッチに対して別のファイルと干渉しないように、一意のファイル名を使用してください。 |
リクエスト
この API は、シングルパートのアップロードをサポートします。content-type が application/octet-stream であることを確認します。API と互換性のないマルチパートリクエストがデフォルトで設定されるので、curl -F オプションは使用しないでください。
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
次の節では、バッチ取得を使用してExperience Platform内のデータを取り込む方法について説明します。
データファイルをに取り込むため Experience Platformの場合、ファイルの階層構造は エクスペリエンスデータモデル (XDM) スキーマは、アップロード先のデータセットに関連付けられています。
XDM スキーマに準拠する CSV ファイルのマッピング方法に関する情報は、サンプル変換ドキュメントに記載されている情報と、適切に書式設定された JSON データファイルの例を参照してください。このドキュメントのサンプルファイルは、次の場所にあります。