Para controlar la cantidad máxima de recursos que el servidor devuelve en la respuesta a una solicitud de lista, configura el campo maxResults. Además, para algunas colecciones (como Events), existe 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 devuelve una página de resultados.
Recuerda que maxResults no garantiza la cantidad de resultados en una página.
Los resultados incompletos se pueden detectar con un campo nextPageToken no vacío en el resultado. Para recuperar la página siguiente, realiza exactamente 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 páginas siguientes hasta que se recuperen todos los resultados.
Por ejemplo, aquí hay 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