Bulk API 2.0 および Bulk API 開発者ガイド
Spring '26 (API version 66.0)
Winter '25 (API version 62.0)
Spring '24 (API version 60.0)
Winter '24 (API version 59.0)
Summer '23 (API version 58.0)
Spring '23 (API version 57.0)
Winter '23 (API version 56.0)
Summer '22 (API version 55.0)
Spring '22 (API version 54.0)
Winter '22 (API version 53.0)
Summer '21 (API version 52.0)
Spring '21 (API version 51.0)
Winter '21 (API version 50.0)
Summer '20 (API version 49.0)
Spring '20 (API version 48.0)
Winter '20 (API version 47.0)
Summer '19 (API version 46.0)
Spring '19 (API version 45.0)
Winter '19 (API version 44.0)
Summer '18 (API version 43.0)
Spring '18 (API version 42.0)
Winter '18 (API version 41.0)
Summer '17 (API version 40.0)
Spring '17 (API version 39.0)
Winter '17 (API version 38.0)
Summer '16 (API version 37.0)
Spring '16 (API version 36.0)
Winter '16 (API version 35.0)
Summer '15 (API version 34.0)
Spring '15 (API version 33.0)
Winter '15 (API version 32.0)
Bulk API 2.0 取得
Bulk API 2.0 では、大きなデータセットを挿入、更新、更新/挿入、または削除できます。カンマ区切り値 (CSV) ファイルで表現されたアップロードデータを準備し、ジョブを作成して、ジョブデータをアップロードします。残りは組織内で Salesforce に処理させます。
Bulk API 2.0 ジョブのデータ行を送信するときには、CSV データを使用します。Bulk API 2.0 では、CSV データの形式設定について、複数項目区切り文字や行末文字など、複数のオプションをサポートしています。
-
CSV ファイルの準備
CSV ファイルのヘッダー行には、処理するオブジェクトの項目名を記述します。それ以降の行は、Salesforce の各レコードに対応します。 -
レコードの有効な日付形式 (2.0)
dateTime 項目と date 項目に対して正しい形式を指定します。 -
ヘッダー行のリレーション項目 (2.0)
Salesforce のオブジェクトの多くは、別のオブジェクトに関連付けられています。たとえば、取引先は取引先責任者の親オブジェクトです。CSV ファイルでは、列ヘッダーでリレーションを示すことにより、関連付けられたオブジェクトへの参照を追加できます。Bulk API でレコードを処理する場合、CSV ファイルの列ヘッダーで RelationshipName.IndexedFieldName という構文を使用して、オブジェクトとその親オブジェクトのリレーションを記述します。RelationshipName は項目のリレーション名、IndexedFieldName は親レコードを一意に識別するインデックス化された項目の名前を示します。項目の relationshipName プロパティの値を取得するには、API で describeSObjects() コールを使用します。 -
サンプルの CSV ファイル
以降の例では、Bulk API 2.0 で CSV データを使用するさまざまな方法を示します。 -
Bulk API 2.0 リファレンス
Bulk API 2.0 の API リファレンスには、ジョブで実行可能なすべてのアクションが含まれます。