REST API 開発者ガイド
jQuery More Results
クエリロケータを使用することにより、SOQL クエリから結果の次のバッチを返します。
SOQL クエリから返される結果数が、要求されたレコードの数または制限を超える場合、応答に含まれるのは、結果のバッチ、false 値の done、およびクエリロケータになります。レコードの次のバッチを取得するには、次の要求でクエリロケータを使用します。まだ返されていないレコードがある場合は、応答に新しいクエリロケータが含まれ、done は false となります。結果の取得は、最初のクエリから done が true になるまで、つまり全結果が返されたことを示すまで、続けることができます。
応答には、QueryAll 要求で返されたレコードの総数 (totalSize)、これ以上結果がないことを示す Boolean 値 (done)、後続のレコードの URI (nextRecordsUrl)、クエリ結果レコードの配列 (records) が含まれます。
構文
- URI
- /services/data/vXX.X/query/queryLocator
- 形式
- JSON、XML
- HTTP のメソッド
- GET
- 認証
- Authorization: Bearer token
- パラメータ
-
パラメータ 説明 queryLocator 後続のクエリ結果を取得するために使用する文字列。まだ未取得の結果がある場合、前のクエリ結果の nextRecordsUrl 項目にクエリロケータが含まれます。
例
- レスポンスボディの例
-
SOQL クエリ実行のリソース
- クエリロケータの使用方法については、「SOQL クエリを実行する」を参照してください。
- バッチサイズを変更する別のオプションについては、「Query Options ヘッダー」を参照してください。
-
SOQL 全般についての詳細は、『SOQL および SOSL リファレンス』を参照してください。