maxResults
フィールドを設定することで、リスト リクエストへのレスポンスでサーバーが返すリソースの最大数を制御できます。さらに、一部のコレクション(イベントなど)では、取得されるエントリの数にハードリミットがあり、サーバーがこれを超えることはありません。イベントの合計数がこの上限を超えると、サーバーは 1 ページ分の結果を返します。
maxResults
は 1 ページの結果の数を保証するものではないことにご注意ください。不完全な結果は、結果に含まれる空でない nextPageToken
フィールドによって検出されます。次のページを取得するには、以前とまったく同じリクエストを実行し、前のページの nextPageToken
の値を使用して pageToken
フィールドを追加します。すべての結果が取得されるまで、次のページに新しい 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