Пролистывание списков ресурсов

Вы можете контролировать максимальное количество ресурсов, которые сервер возвращает в ответ на запрос списка, задав поле maxResults . Более того, для некоторых коллекций (например, «События») существует жесткое ограничение на количество извлекаемых записей, которое сервер никогда не превысит. Если общее количество событий превышает этот максимум, сервер возвращает одну страницу результатов.

Помните, что maxResults не гарантирует количество результатов на одной странице. Неполные результаты можно обнаружить по непустому полю nextPageToken в результате. Чтобы получить следующую страницу, выполните тот же запрос, что и раньше, и добавьте поле pageToken со значением nextPageToken с предыдущей страницы. Новый nextPageToken предоставляется на следующих страницах до тех пор, пока не будут получены все результаты.

Например, вот запрос, за которым следует запрос для получения следующей страницы результатов в постраничном списке:

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

//Result contains

"nextPageToken":"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA",

Последующий запрос берет значение из nextPageToken и отправляет его как значение для pageToken :

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