Vous pouvez contrôler le nombre maximal de ressources que le serveur renvoie 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 serveur ne dépasse jamais une limite stricte du nombre d'entrées récupérées. 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 par page.
Les résultats incomplets peuvent être détectés par 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.
Par exemple, voici une requête suivie de la requête permettant de récupérer la page suivante des résultats 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 pour pageToken:
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA