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

ジョブへのバッチの追加

ジョブに新しいバッチを追加するには、次のような URI 宛てに POST 要求を送信します。リクエストボディには、処理するレコードのリストが含まれます。

URI

https://instance_name—api.salesforce.com/services/async/APIversion/job/jobid/batch

すべてのバッチ処理で使用する、URI 内で指定された API のバージョンは、関連付けられたジョブの API のバージョンと一致している必要があります。

メモ

XML リクエストボディの例

1<?xml version="1.0" encoding="UTF-8"?>
2<sObjects xmlns="http://www.force.com/2009/06/asyncapi/dataload">
3  <sObject>
4    <description>Created from Bulk API</description>
5    <name>[Bulk API] Account 0 (batch 0)</name>
6  </sObject>
7  <sObject>
8    <description>Created from Bulk API</description>
9    <name>[Bulk API] Account 1 (batch 0)</name>
10  </sObject>
11</sObjects>

このサンプルでは、関連付けられたジョブの contentType 項目が XML に設定されているため、バッチデータは XML 形式になっています。バッチデータの別の形式 (CSV や JSON など) については、「JobInfo」を参照してください。

XML レスポンスボディの例

1<?xml version="1.0" encoding="UTF-8"?>
2<batchInfo
3   xmlns="http://www.force.com/2009/06/asyncapi/dataload">
4 <id>751D0000000004rIAA</id>
5 <jobId>750D0000000002lIAA</jobId>
6 <state>Queued</state>
7 <createdDate>2009-04-14T18:15:59.000Z</createdDate>
8 <systemModstamp>2009-04-14T18:15:59.000Z</systemModstamp>
9 <numberRecordsProcessed>0</numberRecordsProcessed>
10 <numberRecordsFailed>0</numberRecordsFailed>
11 <totalProcessingTime>0</totalProcessingTime>
12 <apiActiveProcessingTime>0</apiActiveProcessingTime>
13 <apexProcessingTime>0</apexProcessingTime>
14</batchInfo>

JSON リクエストボディの例

1[
2   {
3      "Name":"[Bulk API] Account 0 (batch 0)",
4      "description" : "Created from Bulk API"
5   },
6   {
7      "Name":"[Bulk API] Account 1 (batch 0)",
8      "description" : "Created from Bulk API"
9   }
10]

このサンプルでは、関連付けられたジョブの contentType 項目が JSON に設定されているため、バッチデータは JSON 形式になっています。

JSON レスポンスボディの例

1{
2   "apexProcessingTime":0,
3   "apiActiveProcessingTime":0,
4   "createdDate":"2015-12-15T21:56:43.000+0000",
5   "id":"751D00000004YGZIA2",
6   "jobId":"750D00000004SkVIAU",
7   "numberRecordsFailed":0,
8   "numberRecordsProcessed":0,
9   "state":"Queued",
10   "systemModstamp":"2015-12-15T21:56:43.000+0000",
11   "totalProcessingTime":0
12}

一括処理ジョブは、Bulk API に準拠していない CSV ファイルを使用して追加できます。「データ項目の対応付け」を参照してください。

メモ

Bulk API 2.0 および Bulk API 開発者ガイド

ジョブへのバッチの追加

関連項目: