Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Sie können die maximale Anzahl von Ressourcen steuern, die der Server in der Antwort auf eine Listenanfrage zurückgibt. Dazu legen Sie das Feld maxResults fest. Außerdem gibt es für einige Sammlungen (z. B. „Ereignisse“) eine feste Obergrenze für die Anzahl der abgerufenen Einträge, die der Server nie überschreitet. Wenn die Gesamtzahl der Ereignisse dieses Maximum überschreitet, gibt der Server eine Ergebnisseite zurück.
Beachten Sie, dass maxResults nicht die Anzahl der Ergebnisse auf einer Seite garantiert.
Unvollständige Ergebnisse sind an einem nicht leeren Feld nextPageToken im Ergebnis zu erkennen. Um die nächste Seite abzurufen, führen Sie dieselbe Anfrage wie zuvor aus und hängen Sie ein pageToken-Feld mit dem Wert nextPageToken von der vorherigen Seite an. Auf den folgenden Seiten wird ein neues nextPageToken angezeigt, bis alle Ergebnisse abgerufen wurden.
Hier ist beispielsweise 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 von nextPageToken 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: 2024-12-21 (UTC)."],[[["Control the maximum number of resources returned in a list request by setting the `maxResults` field, with some collections having hard limits on retrievable entries."],["Detect incomplete results by checking for a non-empty `nextPageToken` field, which indicates the presence of additional pages."],["Retrieve the next page of results by performing the same request and appending a `pageToken` field with the `nextPageToken` value from the previous page."],["The server provides new `nextPageToken` values on subsequent pages until all results are retrieved, enabling complete data retrieval through pagination."]]],[]]
