ページネーション(改ページ位置の自動修正)

リソースのリストを返す GET ベースのすべてのエンドポイントは、カーソルベースのページネーションをサポートしています。デフォルトでは、結果は新しいものから降順で返されます。

クエリパラメーター
maxResults整数
返すオブジェクトの数です。設定されていない場合、デフォルトでは20です。サポートされている最大値は100です。
pageToken文字列
リクエストするページへのカーソルです。リクエストにより、ページごとにオブジェクトを反復処理できるよう現在と次のページのトークンを返します。
レスポンス
object文字列 (値は collection)
オブジェクトの種類を表す文字列です。同じ種類のオブジェクトの場合は同じ値を共有します。
pageToken文字列
リクエストするページへのカーソルです。リクエストにより、ページごとにオブジェクトを反復処理できるよう現在と次のページのトークンを返します。
nextPageToken文字列
次のページへのカーソルです。このトークンを使って次のオブジェクトセットをリクエストすることができます。このカーソルがない場合、それ以上返すオブジェクトがないということです。
maxResults整数
呼び出しにより返されるオブジェクトの最大数です。指定された maxResults クエリパラメーターと同じ値です(指定されていない場合は20)。
results整数
呼び出しで実際に返されたオブジェクトの数です。この値はmaxResults と同じまたはそれ以下になります。
data配列
リクエストにより返されるオブジェクトの配列です。