Vous pouvez contrôler le nombre maximal de ressources renvoyées par le serveur dans le
à une requête de liste en définissant le champ maxResults. De plus,
pour certaines collections (comme les événements), le nombre de collections
récupérées que le serveur ne dépassera jamais. Si le nombre total de
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, effectuez exactement la même requête
comme précédemment et ajoutez un champ pageToken avec la valeur de
nextPageToken sur 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 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