ジョブデータのアップロード

URI

/api/v1/ingest/jobs/{id}/batches

適用開始バージョン

Customer Data Platform v1.0、Salesforce v51.0

形式

CSV

HTTP のメソッド

PUT

認証

Authorization: Bearer access_token

リクエストボディ

レコードデータを含む CSV ファイルを含めます。

1curl --location --request PUT 'https://{instance_url}/api/v1/ingest/jobs/{id}/batches' \
2--header 'Content-Type: text/csv' \
3--header 'Authorization: Bearer {access_token}' \
4--data-binary @type_name-1.csv
5
6HTTP/1.1 202 Accepted

要求パラメータ

パラメータ	説明
id	ジョブの作成要求からレスポンスボディで返されたジョブ ID。

レスポンスボディ

なし。状況コード 202 (承諾済み) を返します。このコードは、Salesforce によってジョブデータが正常に受信されたことを示します。

操作ごとの CSV ファイルレイアウト

更新の場合: 定義したデータストリームの項目に一致するヘッダー行を含む CSV ファイルを作成します。

削除の場合: ヘッダーのない CSV ファイル、すなわち最初の行が生データに対応し、最大 2 列のものを作成します。最初の列には、削除する必要があるレコードに対応する主キー値を指定します。2 列目は、レコードバージョン列がデータストリームに設定されているプロファイルタイプデータの場合のみ必要です。このような場合、2 番目の列には元のレコードよりも大きな日時の値を指定する必要があり、これにより削除要求が元の更新要求よりも優先されることをシステムに認識させます。