Parcourir des listes de ressources
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 (comme 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.
Des 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 que précédemment 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
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 2025/08/29 (UTC)."],[],[],null,["# Page through lists of resources\n\nYou can control the maximum number of resources the server returns in the\nresponse to a list request by setting the `maxResults` field. Furthermore,\nfor some collections (such as Events) there is a hard limit on the number of\nretrieved entries that the server will never exceed. If the total number of\nevents exceeds this maximum, the server returns one page of results.\n\nRemember that `maxResults` does not guarantee the number of results on one page.\nIncomplete results can be detected by a non-empty `nextPageToken` field in\nthe result. In order to retrieve the next page, perform the exact same request\nas previously and append a `pageToken` field with the value of\n`nextPageToken` from the previous page. A new `nextPageToken` is provided\non the following pages until all the results are retrieved.\n\nFor example, here is a query followed by the query for retrieving the\nnext page of results in a paginated list: \n\n GET /calendars/primary/events?maxResults=10&singleEvents=true\n\n //Result contains\n\n \"nextPageToken\":\"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA\",\n\nThe subsequent query takes the value from `nextPageToken` and\nsubmits it as the value for `pageToken`: \n\n GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA"]]
