Вы можете управлять максимальным количеством ресурсов, возвращаемых сервером в ответ на запрос списка, задав поле maxResults. Кроме того, для некоторых коллекций (например, Events) существует жесткое ограничение на количество извлекаемых записей, которое сервер никогда не превысит. Если общее количество событий превышает это значение, сервер возвращает одну страницу результатов.
Помните, что параметр 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