ジョブの作成

Data Cloud でデータストリームを作成することは、ジョブを作成するための前提条件となります。ジョブが作成されると、ジョブデータのアップロード要求で処理するデータを受け入れる準備が完了します。

URI

/api/v1/ingest/jobs

適用開始バージョン

Data Cloud v1.0、Salesforce v51.0

形式

JSON

HTTP のメソッド

POST

認証

Authorization: Bearer access_token

リクエストボディ

スキーマで定義されたすべての項目は、要求ペイロード内に存在する必要があります。この条件は、[値が必要です] が true に設定されているかどうかに関係なく成立します。レコードの特定の項目にデータがない場合は、空白の値を送信します。

メモ

1{
2   "object":"my_object",
3   "sourceName":"my_api_connector",
4   "operation":"upsert"
5}

要求パラメーター

パラメーター	説明
object	処理中のデータのオブジェクト種別。使用するオブジェクト種別はジョブあたり 1 つのみです。
operation	ジョブの処理操作。有効な値は upsert および delete です。
sourceName	オブジェクトのソースを表すコネクタの名前。

レスポンスボディ

JSON レスポンスボディは、ジョブ ID に対応する id というプロパティを返します。状態が open に設定され、ジョブが作成されて、データを追加できることを示します。このジョブ id は次のステップのために保管しておいてください。

1HTTP/1.1 201 Created
2{
3       "id": "4d5a4477-e27f-4bc1-a219-31e79407eade",
4       "operation": "upsert",
5       "object": "my_object",
6       "sourceName": "my_api_connector",
7       "createdById": "005R0000000sJ1hIAE",
8       "createdDate": "2021-04-05T13:35:31.000Z",
9       "systemModstamp": "2021-04-05T13:35:31.000Z",
10       "state": "Open",
11       "contentType": "CSV",
12       "apiVersion": v1,
13       "contentUrl": "api/v1/ingest/jobs/4d5a4477-e27f-4bc1-a219-31e79407eade/batches"
14}