sObject Rows を使用したレコードの取得

データが大量ではない外部データソースに関連付けられた外部オブジェクトは、id に 18 文字の Salesforce ID を使用します。それ以外の外部オブジェクトは、id に外部オブジェクトの外部 ID 標準項目を使用します。

レスポンスボディの項目についての詳細は、『SOAP API 開発者ガイド』の「DescribeSObjectResult」を参照してください。

オブジェクトが Account オブジェクトの場合、応答には ETag ヘッダーも含まれます。(例: ETag: "ddpAdaTHz+GcV35e7NLJ9iKD3XXVqAzXT1Sl2ykkP7g=--gzip") この ETag は If-Match ヘッダーと If-None-Match ヘッダーで使用できます。詳細は、「条件付き要求ヘッダー」を参照してください。

構文

URI

/services/data/vXX.X/sobjects/sObject/id/

形式

JSON、XML

HTTP メソッド

GET

認証

Authorization: Bearer token

パラメーター

パラメーター	説明
sObject	オブジェクトの名前。たとえば、Account などです。
id	オブジェクトの識別子。たとえば、001R0000005hDFYIA2 のようになります。
fields	レスポンスボディで返される項目と値を指定する項目のカンマ区切りのリスト。たとえば、?fields=name,description,numberofemployees,industry のようになります。
If-Match	1 つ以上の ETag のカンマ区切りリストを指定する省略可能なヘッダー。これは、Account オブジェクトで使用される場合にのみ影響します。要求は、Account の ETag がリストに含まれている ETag と一致する場合にのみ処理されます。 例: If-Match: "94C83JSreaVMGpL+lUzv8Dr3inI0kCvuKATVJcTuApA=--gzip", "ddpAdaTHz+GcV35e7NLJ9iKD3XXVqAzXT1Sl2ykkP7g=--gzip"。
If-None-Match	1 つ以上の ETag のカンマ区切りリストを指定する省略可能なヘッダー。これは、Account オブジェクトで使用される場合にのみ影響します。要求は、Account の ETag がリストに含まれている ETag と一致しない場合にのみ処理されます。 例: If-None-Match: "94C83JSreaVMGpL+lUzv8Dr3inI0kCvuKATVJcTuApA=--gzip", "ddpAdaTHz+GcV35e7NLJ9iKD3XXVqAzXT1Sl2ykkP7g=--gzip"。
If-Modified-Since	日時を指定する省略可能なヘッダー。この要求では、その日時以降に変更されたレコードが返されます。 形式は EEE, dd MMM yyyy HH:mm:ss z です。 例: If-Modified-Since: Mon, 30 Nov 2020 08:34:54 MST。
If-Unmodified-Since	日時を指定する省略可能なヘッダー。この要求では、その日時以降に変更されなかったレコードが返されます。 形式は EEE, dd MMM yyyy HH:mm:ss z です。 例: If-Unmodified-Since: Mon, 30 Nov 2020 08:34:54 MST。

例

レコードを取得する例については、「標準オブジェクトレコードから項目値を取得する」を参照してください。