Sie können die maximale Anzahl von 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 niemals überschreiten wird. 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.
Unvollständige Ergebnisse können durch ein nicht leeres Feld nextPageToken im Ergebnis erkannt werden. Um die nächste Seite abzurufen, führen Sie genau dieselbe Anfrage wie zuvor aus und fügen Sie ein Feld pageToken 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 ist 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",
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