В примере ниже показано, как получить дополнительные наборы результатов для запросов к YouTube Data API (v3).
В API используется параметр maxResults, чтобы указать, сколько объектов должно быть включено в ответ API. Этот параметр поддерживают почти все методы list API (videos.list, playlists.list и т. д.).
Если для запроса доступны дополнительные результаты, ответ API будет содержать свойство nextPageToken, свойство prevPageToken или оба этих свойства. Значения этих свойств можно использовать для настройки параметра pageToken, чтобы получить дополнительную страницу результатов.
Например, следующий запрос позволяет получить результаты поиска по 10 самым популярным видео, соответствующим запросу "собака на скейтборде":
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &maxResults=10 &order=viewCount &q=skateboarding+dog &type=video
Ответ API содержит первые 10 совпадений для запроса, а также свойство nextPageToken, которое можно использовать для получения следующих 10 результатов:
Приведенный ниже запрос возвращает следующие 10 результатов:
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &maxResults=10 &order=viewCount &pageToken=CAoQAA &q=skateboarding+dog &type=video
Примечание. Чтобы выполнить этот запрос в APIs Explorer, вам может потребоваться обновить значение параметра pageToken. Выполните запрос, который возвращает первые 10 результатов, чтобы получить правильное значение параметра pageToken.