Vous pouvez contrôler le nombre maximal de ressources renvoyées par le serveur dans la réponse à une requête de liste en définissant le champ maxResults. De plus, pour certaines collections (telles que les événements), le nombre d'entrées récupérées est limité et le serveur ne le dépassera jamais. Si le nombre total d'événements dépasse ce maximum, le serveur renvoie une page de résultats.
N'oubliez pas que maxResults ne garantit pas le nombre de résultats sur une page.
Vous pouvez détecter les résultats incomplets grâce à un champ nextPageToken non vide dans le résultat. Pour récupérer la page suivante, effectuez exactement la même requête qu'auparavant et ajoutez un champ pageToken avec la valeur de nextPageToken de la page précédente. Un nouveau nextPageToken est fourni sur les pages suivantes jusqu'à ce que tous les résultats soient récupérés.
Voici un exemple de requête, suivi de la requête permettant de récupérer la page de résultats suivante dans une liste paginée :
GET /calendars/primary/events?maxResults=10&singleEvents=true
//Result contains
"nextPageToken":"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA",
La requête suivante prend la valeur de nextPageToken et l'envoie comme valeur de pageToken :
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA