リソースの一覧を順番に確認する

サーバーが返すリソースの最大数を制御するには、 list リクエストに対して maxResults フィールドを設定します。さらに 一部のコレクション（イベントなど）では、コレクションの数にハードリミットが 制限されます。イベントの合計数が イベントがこの上限を超えると、サーバーは 1 ページ分の結果を返します。

maxResults は 1 ページの結果の数を保証するものではありません。 不完全な結果は、空でない nextPageToken フィールドによって検出される可能性があります。 返されます。次のページを取得するには、まったく同じリクエストを実行します。 pageToken フィールドを追加して 前のページから nextPageToken。新しい nextPageToken が指定されている すべての結果が取得されるまで、以降のページに繰り返し読み込みます。

たとえば、次の例では、クエリの後に、オブジェクトを取得するクエリを ページ分けされたリストの結果の次のページ:

GET /calendars/primary/events?maxResults=10&singleEvents=true

//Result contains

"nextPageToken":"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA",

後続のクエリは nextPageToken から値を取得し、 これを pageToken の値として送信します。

GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA