REST API 開発者ガイド
j少ない往復回数での複数レコードの削除
sObject コレクションを使用した DELETE 要求によって、最大 200 件のレコードを削除し、DeleteResult オブジェクトのリストを返します。エラーが発生した場合に要求全体をロールバックするかどうかを選択できます。
要求の構文
DELETE /vXX.X/composite/sobjects?ids=recordId,recordId
パラメータ
| パラメータ | 説明 |
|---|---|
| allOrNone | 省略可能。いずれかのオブジェクトの削除が失敗したときに要求全体をロールバックするのか (true)、それとも要求内のその他のオブジェクトの削除を個別に続行するのかを示します。デフォルトは、false です。 |
| ids | 必須。最大 200 個の削除するオブジェクトの ID のリスト。異なるオブジェクト種別の ID を含めることができ、カスタムオブジェクトも使用できます。 |
使用のガイドライン
- DeleteResult オブジェクトは、削除するオブジェクトの ID が指定された順に返されます。
- 複数のオブジェクト種別のレコードを削除する場合、いずれかのオブジェクト種別が Salesforce の [設定] 領域の機能に関連していると、1 回のコールでは削除することができません。
エラーの確認
- 要求が適切な形式でない場合、API は 400 Bad Request HTTP 状況を返します。要求の構文を修正し、再試行してください。
- 要求が適切な形式の場合、API は 200 OK HTTP 状況を返します。項目が正常に処理された場合、success フラグがその項目で表示されます。エラー情報は errors 配列で返されます。
要求の例
レ��ポンスボディの例
次の例は、すべての項目を正常に処理した場合の応答を示しています。
次の例は、一部の項目でエラーが発生し、allOrNone が false である場合の応答を示しています。
次の例は、一部の項目でエラーが発生し、allOrNone が true である場合の応答を示しています。