Разъяснение по maxResults и nextPageToken с помощью API Диска Google v2

Мне просто нужно разъяснение в отношении функции Files: list API Google Диска здесь:

https://developers.google.com/drive/v2/reference/files/list

Какое максимальное значение можно задать с помощью maxResults? Я предполагаю, что это значение вычисляет количество результатов на следующей странице результатов?

Кроме того, является ли nextPageToken просто частью строки запроса, которая должна быть передана с помощью nextLink, чтобы получить следующую страницу результатов?

Спасибо!

Ответы

Ответ 1

Параметр запроса maxResults может использоваться для ограничения (или увеличения) количества элементов, возвращаемых в запросе списка. Существует значение по умолчанию и жесткий предел, установленный нашим сервером. К сожалению, мы обычно не документируем эти числа, так как они могут легко меняться и рекомендовать разработчикам искать nextPageToken и/или nextLink в полученной коллекции, чтобы узнать, были ли возвращены все элементы.

Атрибут nextPageToken должен использоваться как параметр запроса pageToken в запросе списка. Если вы используете nextLink из результирующей коллекции, вам не нужно указывать параметр запроса pageToken, поскольку он уже должен быть включен.