Strony z listą zasobów

Maksymalną liczbę zasobów zwracanych przez serwer w odpowiedzi na żądanie listy możesz kontrolować, ustawiając pole maxResults. Ponadto w przypadku niektórych kolekcji (np. Zdarzeń) istnieje sztywny limit liczby pobieranych wpisów, którego serwer nigdy nie przekroczy. Jeśli łączna liczba zdarzeń przekroczy tę maksymalną wartość, serwer zwróci 1 stronę wyników.

Pamiętaj, że maxResults nie gwarantuje liczby wyników na jednej stronie. Niepełne wyniki można wykryć po niepustym polu nextPageToken w wyniku. Aby pobrać następną stronę, wykonaj dokładnie to samo żądanie co poprzednio i dołącz do pola pageToken wartość pola nextPageToken z poprzedniej strony. Na kolejnych stronach wyświetla się nowa wartość nextPageToken, dopóki nie zostaną pobrane wszystkie wyniki.

Oto przykład zapytania i zapytania służącego do pobrania następnej strony wyników na liście podzielonej na strony:

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

//Result contains

"nextPageToken":"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA",

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

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