sObject Rows by External ID を使用したレコードの更新/挿入

• 外部 ID が既存レコードと一致しない場合は、リクエストボディに従って新規レコードが作成されます。
• 外部 ID が 1 つの既存レコードと一致する場合は、リクエストボディに従って既存レコードが更新されます。
• 外部 ID が複数の既存レコードと一致する場合は、300 エラーが返され、レコードは作成も更新もされません。

External ID 属性と Unique 属性の両方が選択された (インデックスが一意) カスタム項目を持つオブジェクトのレコードを更新/挿入する場合、特別な権限は必要ありません。Unique 属性は重複作成を防止します。[外部 ID] 属性が選択され、Unique 属性が選択されていない (インデックスが一意ではない) オブジェクトのレコードを更新/挿入する場合、クライアントアプリケーションがこのコールを実行するには「すべてのデータの参照」権限が必要です。

構文

URI

/services/data/vXX.X/sobjects/sObject/fieldName/fieldValue

形式

JSON、XML

HTTP メソッド

PATCH

認証

Authorization: Bearer token

パラメータ

なし

例

外部 ID に基づいてレコードを作成および更新する例は、「外部 ID を使用してレコードを挿入/更新 (Upsert) する」を参照してください。