Strony z listą zasobów

Możesz kontrolować maksymalną liczbę zasobów zwracanych przez serwer w odpowiedzi na żądanie listy, ustawiając pole maxResults. Ponadto w przypadku niektórych zbiorów (takich jak Zdarzenia) istnieje stały limit liczby pobranych wpisów, których serwer nigdy nie przekroczy. Jeśli łączna liczba zdarzeń przekracza ten limit, serwer zwraca jedną 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 pole pageToken o wartości nextPageToken z poprzedniej strony. Dopóki nie pobierzesz wszystkich wyników, na kolejnych stronach będzie dostępny nowy nextPageToken.

Poniżej przedstawiamy przykład zapytania, po którym następuje zapytanie umożliwiające pobranie następnej strony wyników z listy podzielonej na strony:

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

//Result contains

"nextPageToken":"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA",

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

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