Możesz określić maksymalną liczbę zasobów zwracanych przez serwer w odpowiedzi na żądanie listy, ustawiając pole maxResults
. Ponadto w przypadku niektórych kolekcji (np. zdarzeń) istnieje sztywny limit pobranych wpisów, którego serwer nigdy nie przekroczy. Jeśli łączna liczba zdarzeń przekroczy tę maksymalną wartość, serwer zwróci jedną stronę wyników.
Pamiętaj, że maxResults
nie gwarantuje liczby wyników na jednej stronie.
Niepełne wyniki można rozpoznać po niepustym polu nextPageToken
w wyniku. Aby pobrać następną stronę, wykonaj dokładnie to samo żądanie co wcześniej i dołącz pole pageToken
z wartością nextPageToken
z poprzedniej strony. Na kolejnych stronach będzie widoczny nowy symbol nextPageToken
, dopóki nie zostaną pobrane wszystkie wyniki.
Oto przykład zapytania, a następnie zapytania o pobranie 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ść parametru pageToken
:
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA