É possível controlar o número máximo de recursos que o servidor retorna na resposta a uma solicitação de lista definindo o campo maxResults. Além disso, para algumas coleções (como eventos), há um limite fixo no número de entradas recuperadas que o servidor nunca excede. Se o número total de eventos exceder esse máximo, o servidor retornará uma página de resultados.
Lembre-se de que maxResults não garante o número de resultados em uma página.
Um campo nextPageToken não vazio na resposta indica resultados incompletos.
Para recuperar a próxima página, repita a solicitação anterior e anexe um parâmetro pageToken com o valor de nextPageToken da página anterior. Cada página subsequente fornece um novo nextPageToken até que a resposta contenha todos os resultados.
Por exemplo, a consulta a seguir solicita a primeira página:
GET /calendars/primary/events?maxResults=10&singleEvents=true
A resposta contém um nextPageToken:
{
"nextPageToken": "CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA"
}
A consulta subsequente extrai o valor de nextPageToken e o envia como o valor de pageToken:
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA