Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Sie können die maximale Anzahl der Ressourcen, die der Server als Antwort auf eine Listenanfrage zurückgibt, mit dem Feld maxResults festlegen. Außerdem gibt es für einige Sammlungen (z. B. „Events“) ein festes Limit für die Anzahl der abgerufenen Einträge, das der Server niemals überschreitet. Wenn die Gesamtzahl der Ereignisse dieses Maximum überschreitet, gibt der Server eine Seite mit Ergebnissen zurück.
Beachten Sie, dass maxResults nicht die Anzahl der Ergebnisse auf einer Seite garantiert.
Unvollständige Ergebnisse sind daran zu erkennen, dass das Feld nextPageToken im Ergebnis nicht leer ist. Wenn Sie die nächste Seite abrufen möchten, führen Sie dieselbe Anfrage wie zuvor aus und hängen Sie ein pageToken-Feld mit dem Wert von nextPageToken von der vorherigen Seite an. Auf den folgenden Seiten wird ein neues nextPageToken bereitgestellt, bis alle Ergebnisse abgerufen wurden.
Hier sehen Sie ein Beispiel für eine Abfrage, gefolgt von der Abfrage zum Abrufen der nächsten Seite mit Ergebnissen in einer paginierten Liste:
GET /calendars/primary/events?maxResults=10&singleEvents=true
//Result contains
"nextPageToken":"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA",
In der nachfolgenden Abfrage wird der Wert aus nextPageToken übernommen und als Wert für pageToken übergeben:
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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"]]
