Defina o campo maxResults
para controlar o número máximo de recursos que o servidor retorna na resposta a uma solicitação de lista. Além disso, para algumas coleções (como Eventos), há um limite rígido no número de entradas recuperadas que o servidor jamais excederá. Se o número total de eventos exceder esse limite, 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.
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
de antes e anexe um campo pageToken
com o valor de
nextPageToken
da página anterior. Um novo nextPageToken
será fornecido
nas páginas a seguir até que todos os resultados sejam recuperados.
Por exemplo, esta é 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 seguinte recebe o valor de nextPageToken
e o envia como o valor para pageToken
:
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA