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