この文章は 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 クエリ実行のリソース