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