Strony z listą zasobów

Możesz kontrolować maksymalną liczbę zasobów, które serwer zwraca w odpowiedzi na żądanie listy, ustawiając pole maxResults. Ponadto w przypadku niektórych kolekcji (np. zdarzeń) obowiązuje limit liczby pobranych wpisów, którego serwer nigdy nie przekracza. Jeśli łączna liczba zdarzeń przekroczy ten limit, serwer zwróci jedną stronę wyników.

Pamiętaj, że maxResults nie gwarantuje liczby wyników na jednej stronie. Niepuste pole nextPageToken w odpowiedzi wskazuje na niepełne wyniki. Aby pobrać następną stronę, powtórz poprzednie żądanie i dodaj parametr pageToken z wartością nextPageToken z poprzedniej strony. Każda kolejna strona zawiera nowy nextPageToken, dopóki odpowiedź nie będzie zawierać wszystkich wyników.

Na przykład to zapytanie żąda pierwszej strony:

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

Odpowiedź zawiera nextPageToken:

{
  "nextPageToken": "CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA"
}

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

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