In Ressourcenlisten blättern

Sie können die maximale Anzahl von Ressourcen festlegen, die der Server in der Antwort auf eine Listenanfrage zurückgibt. Legen Sie dazu das Feld maxResults fest. Darüber hinaus gibt es für einige Sammlungen (z. B. Ereignisse) ein festes Limit 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 Seite mit Ergebnissen zurück.

maxResults garantiert nicht die Anzahl der Ergebnisse auf einer Seite. Unvollständige Ergebnisse können durch ein nicht leeres Feld nextPageToken im Ergebnis erkannt werden. Um die nächste Seite abzurufen, führen Sie dieselbe 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 ein neuer nextPageToken bereitgestellt, bis alle Ergebnisse abgerufen wurden.

Das folgende Beispiel zeigt eine Abfrage, auf die die Abfrage zum Abrufen der nächsten Ergebnisseite in einer paginierten Liste folgt:

GET /calendars/primary/events?maxResults=10&singleEvents=true

//Result contains

"nextPageToken":"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA",

Die folgende Abfrage nimmt den Wert aus nextPageToken und übergibt ihn als Wert für pageToken:

GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA