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

SOQL クエリを実行する

すべての結果を 1 つの応答で返すか、または必要に応じて、結果の一部と、残りの結果を取得するために使用する識別子を返す SOQL クエリを実行するには、Query リソースを使用します。

次のクエリは、すべての Account レコードを対象に name 項目の値を要求します。

クエリを実行する場合の使用例

1curl https://yourInstance.salesforce.com/services/data/v54.0/query/?q=SELECT+name+from+Account -H "Authorization: Bearer token"

クエリを実行する場合のリクエストボディの例

不要

クエリを実行する場合のレスポンスボディの例

1{
2    "done" : true,
3    "totalSize" : 14,
4    "records" : 
5    [ 
6        {  
7            "attributes" : 
8            {    
9                "type" : "Account",    
10                "url" : "/services/data/v54.0/sobjects/Account/001D000000IRFmaIAH"  
11            },  
12            "Name" : "Test 1"
13        }, 
14        {  
15            "attributes" : 
16            {    
17                "type" : "Account",    
18                "url" : "/services/data/v54.0/sobjects/Account/001D000000IomazIAB"  
19            },  
20            "Name" : "Test 2"
21        }, 
22
23        ...
24
25    ]
26}

SOQL クエリの残りの結果の取得

最初のクエリで結果の一部のみを返す場合、応答の最後に nextRecordsUrl という項目が含まれます。たとえば、クエリの最後に次の属性があるとします。

1"nextRecordsUrl" : "/services/data/v54.0/query/01gD0000002HU6KIAW-2000"

この場合、レコードの次のバッチを要求し、すべてのレコードが取得されるまでこの操作を繰り返します。これらの要求は nextRecordsUrl を使用し、パラメータを含みません。

クエリの残りの結果を取得する場合の使用例

1curl https://yourInstance.salesforce.com/services/data/v54.0/query/01gD0000002HU6KIAW-2000 -H "Authorization: Bearer token"

クエリの残りの結果を取得する場合のリクエストボディの例

不要

クエリの残りの結果を取得する場合のレスポンスボディの例

1{
2    "done" : true,
3    "totalSize" : 3214,
4    "records" : [...]
5}

REST API 開発者ガイド

SOQL クエリを実行する

SOQL クエリの残りの結果の取得