Vous pouvez contrôler le nombre maximal de ressources renvoyées par le serveur dans sa 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 au 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. Pour 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 de la requête permettant de récupérer la page suivante de 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