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