Strony z listą zasobów

Możesz kontrolować maksymalną liczbę zasobów zwracanych przez serwer w sekcji odpowiedź na żądanie wyświetlenia listy przez ustawienie pola maxResults. Ponadto w przypadku niektórych kolekcji (takich jak Zdarzenia) istnieje stały limit liczby pobrane wpisy, których serwer nigdy nie przekroczy. Jeśli łączna liczba przekroczy tę wartość, serwer zwróci jedną stronę wyników.

Pamiętaj, że maxResults nie gwarantuje liczby wyników na jednej stronie. Niepełne wyniki mogą być wykrywane przez niepuste pole nextPageToken w w konsekwencji wyniku. Aby pobrać następną stronę, wykonaj dokładnie to samo żądanie jak wcześniej i dołącz pole pageToken z wartością nextPageToken od poprzedniej strony. Dodano nowy element (nextPageToken) na kolejnych stronach, aż zostaną pobrane wszystkie wyniki.

Oto na przykład zapytanie, a po nim zapytanie o pobranie danych następna strona wyników na liście podzielonej na strony:

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

//Result contains

"nextPageToken":"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA",

Kolejne zapytanie pobierze wartość z nextPageToken i przesyła ją jako wartość dla pageToken:

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