この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

ジョブの作成

ジョブを作成します。このジョブは、非同期処理のために Salesforce に送信される一括操作 (と関連付けられたデータ) を表します。ジョブデータは、ジョブデータのアップロード要求を使用するか、マルチパート作成ジョブ要求の一部としてシチエします。

URI

/services/data/vXX.X/jobs/ingest

形式

JSON

HTTP メソッド

POST

認証

Authorization: Bearer token

パラメータ

なし。

リクエストボディ

プロパティ	型	説明	必須項目/省略可能
`columnDelimiter`	ColumnDelimiterEnum	CSV ジョブデータに使用される列区切り文字。デフォルト値は `COMMA` です。有効な値は、次のとおりです。 `BACKQUOTE` — バッククォート文字 (`) `CARET` — キャレット文字 (^) `COMMA` — カンマ文字 (,) (デフォルトの区切り文字) `PIPE` — パイプ文字 (\|) `SEMICOLON` — セミコロン文字 (;) `TAB` — タブ文字	省略可能
`contentType`	ContentType	ジョブのコンテンツタイプ。有効な値 (およびデフォルト) は `CSV` のみです。	省略可能
`externalIdFieldName`	string	更新されるオブジェクトの外部 ID 項目。更新/挿入操作でのみ必要です。項目値は、CSV ジョブデータ内にも存在する必要があります。	更新/挿入操作で必須
`lineEnding`	LineEndingEnum	CSV ジョブデータに使用される行末で、データ行の終わりを示します。デフォルトは `LF` です。有効な値は、次のとおりです。 `LF` — 改行文字 `CRLF` — 行頭復帰および改行文字	省略可能
`object`	string	処理中のデータのオブジェクト種別。使用するオブジェクト種別はジョブあたり 1 つのみです。	必須
`operation`	OperationEnum	ジョブの処理操作。有効な値は、次のとおりです。 `insert` `delete` `update` `upsert`	必須

マルチパート要求の場合、リクエストボディには CSV レコードデータを含めることもできます。詳細は「使用上の注意」を参照してください。

レスポンスボディ

プロパティ	型	説明
`apiVersion`	string	ジョブが作成された API バージョン。
`columnDelimiter`	ColumnDelimiterEnum	CSV ジョブデータに使用される列区切り文字。次のような値があります。 `BACKQUOTE` — バッククォート文字 (`) `CARET` — キャレット文字 (^) `COMMA` — カンマ文字 (,) (デフォルトの区切り文字) `PIPE` — パイプ文字 (\|) `SEMICOLON` — セミコロン文字 (;) `TAB` — タブ文字
`concurrencyMode`	ConcurrencyModeEnum	ジョブの同時実行モード。次のような値があります。 `Parallel`: レコードを並列モードで処理します。これはデフォルト値です。 `Serial`: レコードを逐次モードで処理します。並列処理を行うと、データベースの競合が生じる可能性があります。競合が激しいと、ジョブが失敗する可能性があります。このような場合は、ジョブを `serial` 同時実行モードで送信します。このモードでは、レコードが 1 つずつ順序に従って処理されますが、処理時間が大幅に増える可能性があります。
`contentType`	ContentType	処理されるデータの形式。サポートされるのは CSV のみです。
`contentUrl`	URL	このジョブのジョブデータのアップロード要求で使用する URL。ジョブの状況が `Open` の場合にのみ有効です。
`createdById`	string	ジョブを作成したユーザの ID。
`createdDate`	dateTime	ジョブが作成された日時を UTC のタイムゾーンで示します。
`externalIdFieldName`	string	更新/挿入の外部 ID 項目の名前。
`id`	string	このジョブの一意の ID。
`jobType`	JobTypeEnum	ジョブの種別。次のような値があります。 `BigObjectIngest` — BigObjects ジョブ `Classic` — Bulk API 1.0 ジョブ `V2Ingest` — Bulk API 2.0 ジョブ
`lineEnding`	LineEndingEnum	CSV ジョブデータに使用される行末。次のような値があります。 `LF` — 改行文字 `CRLF` — 行頭復帰および改行文字
`object`	string	処理中のデータのオブジェクト種別。
`operation`		ジョブの処理操作。次のような値があります。 `insert` `delete` `update` `upsert`
`state`	JobStateEnum	ジョブの現在の処理状況。次のような値があります。 `Open` — ジョブが作成され、このジョブにデータを追加できます。 `UploadComplete` — このジョブには新しいデータを追加できません。終了したジョブの編集や保存はできません。 `Aborted` — ジョブが中止されました。ジョブを中止するには、自分がそのジョブの作成者であるか、「データインテグレーションの管理」権限が有効になっている必要があります。 `JobComplete` — ジョブが Salesforce によって処理されました。 `Failed` — ジョブが失敗しました。正常に処理されたジョブデータはロールバックされません。
`systemModstamp`	dateTime	ジョブが完了した日時を UTC のタイムゾーンで示します。

使用上の注意

少量のジョブデータ (20,000 文字以下) の場合、マルチパート要求を使用してジョブを作成し、ジョブのデータすべてをアップロードできます。次の例の要求ヘッダーおよびリクエストボディでは、マルチパート形式を使用してジョブ情報とジョブデータの両方を収容しています。

1Content-Type: multipart/form-data; boundary=BOUNDARY

1--BOUNDARY
2Content-Type: application/json
3Content-Disposition: form-data; name="job"
4
5{
6  "object":"Contact",
7  "contentType":"CSV",
8  "operation":"insert"
9}
10
11--BOUNDARY
12Content-Type: text/csv
13Content-Disposition: form-data; name="content"; filename="content"
14
15(Content of your CSV file)
16--BOUNDARY--

Bulk API 2.0

ジョブの作成