Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Вы можете контролировать максимальное количество ресурсов, которые сервер возвращает в ответ на запрос списка, задав поле 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
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-01-10 UTC."],[[["Control the maximum number of resources returned in a list request by setting the `maxResults` field, with some collections having hard limits on retrievable entries."],["Detect incomplete results by checking for a non-empty `nextPageToken` field, which indicates the presence of additional pages."],["Retrieve the next page of results by performing the same request and appending a `pageToken` field with the `nextPageToken` value from the previous page."],["The server provides new `nextPageToken` values on subsequent pages until all results are retrieved, enabling complete data retrieval through pagination."]]],[]]