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), il existe une limite stricte sur le nombre d'entrées récupérées que le serveur ne 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.
Les résultats incomplets peuvent être détectés par un champ nextPageToken non vide dans le résultat. Afin de récupérer la page suivante, exécutez exactement la même requête qu'auparavant et ajoutez un champ pageToken avec la valeur 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 d'une 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 en tant que valeur de pageToken:
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA