Sie können die maximale Anzahl der Ressourcen steuern, die der Server in der Antwort auf eine Listenanfrage zurückgibt, indem Sie das Feld maxResults festlegen. Außerdem gibt es für einige Sammlungen (z. B. Ereignisse) ein festes Limit für die Anzahl der abgerufenen Einträge, das der Server nie überschreitet. Wenn die Gesamtzahl der Ereignisse dieses Maximum übersteigt, gibt der Server eine Seite mit Ergebnissen zurück.
Beachten Sie, dass maxResults die Anzahl der Ergebnisse auf einer Seite nicht garantiert.
Ein nicht leeres Feld nextPageToken in der Antwort weist auf unvollständige Ergebnisse hin.
Wiederholen Sie die vorherige Anfrage und fügen Sie einen pageToken-Parameter mit dem Wert von nextPageToken von der vorherigen Seite an, um die nächste Seite abzurufen. Jede nachfolgende Seite enthält ein neues nextPageToken, bis die Antwort alle Ergebnisse enthält.
Mit der folgenden Abfrage wird beispielsweise die erste Seite angefordert:
GET /calendars/primary/events?maxResults=10&singleEvents=true
Die Antwort enthält ein nextPageToken:
{
"nextPageToken": "CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA"
}
Die nachfolgende Abfrage übernimmt den Wert von nextPageToken und sendet ihn als Wert für pageToken:
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA