É 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 para o número de
entradas recuperadas que o servidor nunca vai exceder. 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.
É possível detectar resultados incompletos por um campo nextPageToken
não vazio
no resultado. Para recuperar a próxima página, faça exatamente a mesma solicitação
como antes e anexe um campo pageToken
com o valor de
nextPageToken
da página anterior. Um novo nextPageToken
será fornecido
nas páginas seguintes até que todos os resultados sejam recuperados.
Por exemplo, veja a seguir uma consulta seguida pela outra 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 seguinte recebe o valor de nextPageToken
e o envia como o valor de pageToken
:
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA