Query More Results

最初の SOQL クエリからの結果数が 2,000 レコードの制限を超える場合、応答では、最初の 2,000 件の結果セットとクエリロケータが含まれ、done は false 値になります。後続の 2,000 レコードを取得するには、次の要求でこのクエリロケータを使用します。まだ返されていないレコードがある場合は、応答に新しいクエリロケータが含まれ、done は false となります。結果の取得は、最初のクエリから done が true になるまで、つまり全結果が返されたことを示すまで、続けることができます。

URI

/services/data/vXX.X/query/query_locator

形式

JSON、XML

HTTP のメソッド

GET

認証

Authorization: Bearer token

パラメータ

パラメータ	説明
query_locator	後続のクエリ結果を取得するために使用する文字��。まだ未取得の結果がある場合、前のクエリ結果の nextRecordsUrl 項目にクエリロケータが含まれます。

レスポンスボディ

応答には、QueryAll 要求で返されたレコードの総数 (totalSize)、これ以上結果がないことを示す Boolean 値 (done)、後続のレコードの URI (nextRecordsUrl)、クエリ結果レコードの配列 (records) が含まれます。

レスポンスボディの例

1{
2  "totalSize": 3222,
3  "done": false,
4  "nextRecordsUrl": "/services/data/v57.0/query/01gRO0000016PIAYA2-500",
5  "records": [
6    {
7      "attributes": {
8        "type": "Contact",
9        "url": "/services/data/v57.0/sobjects/Contact/003RO0000035WQgYAM"
10      },
11      "Id": "003RO0000035WQgYAM",
12      "Name": "John Smith"
13    },
14    ...
15  ]
16}