Sie können die maximale Anzahl von Ressourcen steuern, die der Server in der Antwort auf eine Listenanfrage zurückgibt. Legen Sie dazu das Feld maxResults fest. Darüber hinaus gibt es bei einigen Sammlungen (z. B. Ereignissen) eine feste Beschränkung für die Anzahl der abgerufenen Einträge, die der Server nie überschreiten wird. Wenn die Gesamtzahl der Ereignisse diesen Höchstwert überschreitet, gibt der Server eine Ergebnisseite zurück.
Beachten Sie, dass maxResults keine Garantie für die Anzahl der Ergebnisse auf einer Seite gibt.
Unvollständige Ergebnisse können durch ein nicht leeres nextPageToken-Feld im Ergebnis erkannt werden. Führen Sie zum Abrufen der nächsten Seite genau die gleiche Anfrage wie zuvor aus und hängen Sie das Feld pageToken mit dem Wert von nextPageToken von der vorherigen Seite an. Auf den folgenden Seiten wird so lange ein neues nextPageToken-Objekt bereitgestellt, bis alle Ergebnisse abgerufen sind.
Hier sehen Sie beispielsweise eine Abfrage, gefolgt von der Abfrage zum Abrufen der nächsten Ergebnisseite in einer paginierten Liste:
GET /calendars/primary/events?maxResults=10&singleEvents=true
//Result contains
"nextPageToken":"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA",
Die folgende Abfrage ruft den Wert von nextPageToken ab und sendet ihn als Wert für pageToken:
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA