Pagina las listas de recursos

Puedes controlar la cantidad máxima de recursos que muestra el servidor en la respuesta a una solicitud de lista si configuras el campo maxResults. Además, para algunas colecciones (como los eventos), existe un límite estricto en cuanto a la cantidad de entradas recuperadas que el servidor nunca superará. Si la cantidad total de eventos excede 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 nextPageToken nuevo 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