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