Você pode controlar o número máximo de recursos que o servidor retorna no
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 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 na
o resultado. Para recuperar a próxima página, realize a mesma solicitação
como anteriormente 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 os 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 usa o valor de nextPageToken
e
o envia como o valor de pageToken
:
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA