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 dépasse jamais cette limite. 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.
Un champ nextPageToken non vide dans la réponse indique des résultats incomplets.
Pour récupérer la page suivante, répétez la requête précédente et ajoutez un paramètre pageToken avec la valeur nextPageToken de la page précédente. Chaque page suivante fournit un nouveau nextPageToken jusqu'à ce que la réponse contienne tous les résultats.
Par exemple, la requête suivante demande la première page :
GET /calendars/primary/events?maxResults=10&singleEvents=true
La réponse contient un nextPageToken :
{
"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