Вы можете контролировать максимальное количество ресурсов, возвращаемых сервером в ответе на запрос списка, установив значение в поле 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