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

QueryAll More Results

QueryAll 要求でクエリロケータを使用することにより、後続の結果セットを返します。この API リソースは、指定された QueryAll 要求を実行します。QueryAll More Results のクエリは、API バージョン 29.0 以降で利用できます。

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

QueryAll レスポンスボディの nextRecordsUrl 項目に指定された URI には、queryAll ではなく query が含まれています。次の結果セットを取得するには、同じクエリロケータで Query More Results または QueryAll More Results リソースを使用します。残りの結果には、最初のクエリに一致する削除されたレコードが含まれています。

たとえば、QueryAll 要求のレスポンスボディに "nextRecordsUrl": "/services/data/v57.0/query/01g5e00001AH2dOAAT-4000" が含まれている場合、QueryAll の後続の結果セットを次のいずれかの URI で取得することができます。
  • /services/data/v57.0/query/01g5e00001AH2dOAAT-4000
  • /services/data/v57.0/queryAll/01g5e00001AH2dOAAT-4000

メモ

URI
/services/data/vXX.X/queryAll/query_locator
形式
JSON、XML
HTTP のメソッド
GET
認証
Authorization: Bearer token
パラメータ
パラメータ 説明
query_locator 後続のクエリ結果を取得するために使用する文字列。まだ未取得の結果がある場合、前の QueryAll の結果の 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}

SOQL クエリ実行のリソース