É 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 rígido no número de
entradas recuperadas que o servidor nunca vai exceder. Se o número total de eventos exceder esse máximo, o servidor vai retornar uma página de resultados.
Lembre-se de que maxResults não garante o número de resultados em uma página.
Os resultados incompletos podem ser detectados por um campo nextPageToken não vazio no
resultado. Para recuperar a próxima página, faça a mesma solicitação
anterior e anexe um campo pageToken com o valor de
nextPageToken da página anterior. Um novo nextPageToken é fornecido
nas páginas seguintes até que todos os resultados sejam recuperados.
Por exemplo, aqui está uma consulta seguida pela consulta para recuperar a próxima página de resultados em uma lista paginada:
GET /calendars/primary/events?maxResults=10&singleEvents=true
//Result contains
"nextPageToken":"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA",
A consulta subsequente recebe o valor de nextPageToken e
o envia como o valor de pageToken:
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA