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

少ない往復回数での複数レコードの更新

sObject コレクションを使用した PATCH 要求によって、最大 200 件のレコードを更新し、SaveResult オブジェクトのリストを返します。エラーが発生した場合に要求全体をロールバックするかどうかを選択できます。

要求の構文

PATCH /vXX.X/composite/sobjects

パラメータ

パラメータ	説明
allOrNone	省略可能。いずれかのオブジェクトの更新が失敗したときに要求全体をロールバックするのか (`true`)、それとも要求内のその他のオブジェクトの更新を個別に続行するのかを示します。デフォルトは、`false` です。
records	必須。sObjects のリスト。sObject コレクションを使用する POST 要求では、各オブジェクトの `type` 属性を設定しますが、`id` 項目はどのオブジェクトに対しても設定しません。

使用のガイドライン

リストには最大 200 個のオブジェクトを含めることができます。
リストには異なる種別のオブジェクトを含めることができ、カスタムオブジェクトも使用できます。
各オブジェクトには属性の対応付��が含まれている必要があります。対応付けには type の値が含まれている必要があります。
sObject コレクションを使用して blob データを更新する場合は、他の値も属性の対応付けに必要となります。詳細は、「sObject コレクションを使用した blob レコードのコレクションの挿入」を参照してください。
メモ
各オブジェクトには id 項目が含まれ、有効な ID 値が設定されている必要があります。
オブジェクトは、リストされている順に更新されます。SaveResult オブジェクトは、更新要求が指定された順に返されます。
リクエストボディに複数の種別のオブジェクトが含まれている場合は、チャンクとして処理されます。たとえば、受信したオブジェクトが {account1, account2, contact1, account3} の場合、要求は次のように 3 つのチャンクで処理されます: {{account1, account2}, {contact1}, {account3}}。1 つの要求で最大で 10 個のチャンクを処理できます。
複数のオブジェクト種別のレコードを更新する場合、いずれかのオブジェクト種別が Salesforce の [設定] 領域の機能に関連していると、1 回のコールでは更新することができません。

リクエストボディの例

1PATCH /composite/sobjects
2{
3   "allOrNone" : false,
4   "records" : [{
5      "attributes" : {"type" : "Account"},
6      "id" : "001xx000003DGb2AAG",
7      "NumberOfEmployees" : 27000
8   },{
9      "attributes" : {"type" : "Contact"},
10      "id" : "003xx000004TmiQAAS",
11      "Title" : "Lead Engineer"
12   }]
13}

レスポンスボディの例

1[
2   {
3      "success": true,
4      "id": "001xx000003DGb2AAG",
5      "errors": [],
6      "warnings": []
7   },
8   {
9      "success": true,
10      "id": "003xx000004TmiQAAS",
11      "errors": [],
12      "warnings": []
13   }
14]

REST API 開発者ガイド