É 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 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.
Resultados incompletos podem ser detectados por um campo nextPageToken
não vazio no resultado. Para recuperar a próxima página, faça exatamente a mesma solicitação
que antes e adicione um campo pageToken
com o valor de
nextPageToken
da página anterior. Um novo nextPageToken
é fornecido
nas páginas a seguir até que todos os resultados sejam recuperados.
Por exemplo, aqui está uma consulta seguida da 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 usa o valor de nextPageToken
e
o envia como o valor de pageToken
:
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA