Puedes controlar la cantidad máxima de recursos que muestra el servidor en la respuesta a una solicitud de lista configurando el campo maxResults
. Además, para algunas colecciones (como Eventos), hay un límite estricto en la cantidad de entradas recuperadas que el servidor nunca superará. Si la cantidad total de eventos supera este máximo, el servidor muestra una página de resultados.
Recuerda que maxResults
no garantiza la cantidad de resultados en una página.
Los resultados incompletos se pueden detectar mediante un campo nextPageToken
no vacío en el resultado. Para recuperar la página siguiente, realiza la misma solicitud que antes y agrega un campo pageToken
con el valor de nextPageToken
de la página anterior. Se proporciona un nuevo nextPageToken
en las siguientes páginas hasta que se recuperan todos los resultados.
Por ejemplo, esta es una consulta seguida de la consulta para recuperar la siguiente página de resultados en una lista paginada:
GET /calendars/primary/events?maxResults=10&singleEvents=true
//Result contains
"nextPageToken":"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA",
La consulta posterior toma el valor de nextPageToken
y
lo envía como el valor de pageToken
:
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA