Percorra listas de recursos

É 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