Bulk API 2.0 および Bulk API 開発者ガイド
jマルチパート要求を使用する一括挿入のウォークスルー
このウォークスルーでは、新規レコードの挿入、ジョブのデータのアップロード、状況の確認、結果の取得を行うジョブを作成する手順を説明します。また、1 つのマルチパート要求を使用して、ジョブの作成とジョブデータのアップロードの両方を行います。
- このウォークスルーのすべての手順を一読してください。このドキュメントの残りを確認して、Bulk API 2.0 コールの概要と概念を把握しておくこともお勧めします。
- ワークベンチに習熟します。このウォークスルーではワークベンチを使用して Bulk API 2.0 コールを発行しますが、REST 要求を実行できる任意のツールや開発環境を使用することもできます。
-
ジョブを作成します。
レコードの挿入や更新など、Bulk API 2.0 タスクを実行するには、最初にジョブを作成します。ジョブでは、読み込むオブジェクトの種別 (Contact など) を指定します。また、実行する操作 (挿入や削除など) も指定します。このウォークスルーで作成する「マルチパート」要求では、ジョブを作成する最初の要求にジョブデータが含まれています。
ジョブを作成したら、そのジョブの ID を Bulk API 2.0 要求で使用してジョブを終了または中止 (キャンセル) できます。
- ワークベンチで、組織にログインします。
-
に移動します。Bulk API 2.0 を使用し、次の詳細を指定した POST 要求を発行して新規ジョブを作成し、データをアップロードします。
要求ヘッダー:URI:
1Content-Type: multipart/form-data; boundary=BOUNDARY 2Accept: application/jsonリクエストボディ:1/services/data/vXX.X/jobs/ingest/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 15Name,MailingCity 16Astro Nomical,San Francisco 17Hootie McOwl,San Francisco 18Appy Camper,San Francisco 19Earnie Badger,San Francisco 20--BOUNDARY--この例の場合、「BOUNDARY」は、最初は区切り文字として使用されており、最後はリクエストボディのジョブ詳細とジョブの CSV データ間の境界を示すために使用されています。
ジョブの状況が UploadComplete のジョブ ID を含む応答が返されます。このジョブ ID は、次のステップの Bulk API 2.0 コールで使用します。
-
ジョブの状況と結果を確認します。
全体的なジョブの状況や処理されたレコード数など、ジョブに関する基本的な状況情報を取得するには、次の詳細を指定した GET 要求を使用します。
要求ヘッダー:URI:1Content-Type: application/json; charset=UTF-8 2Accept: application/json1/services/data/vXX.X/jobs/ingest/jobId/ジョブが完了して、状況が JobComplete (または Failed) になったら、次の詳細を指定して GET 要求を発行し、正常に処理されたジョブデータレコードの詳細を取得できます。
要求ヘッダー:1Content-Type: application/json; charset=UTF-8 2Accept: text/csv1/services/data/vXX.X/jobs/ingest/jobId/successfulResults/CSV データを含む応答が返されます。各行にはレコード ID とレコードが正常に処理されたかどうかに関する情報が含まれます。処理中にエラーが発生したレコードの詳細を取得するには、successfulResults リソースではなく failedResults リソースを指定した GET 要求を使用します。