В следующем примере показано, как получить дополнительные наборы результатов для запросов 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
Примечание. Возможно, вам потребуется обновить значение параметра pageToken
, чтобы выполнить этот запрос в обозревателе API. Выполните запрос, который извлекает первые 10 результатов, чтобы получить правильное значение параметра pageToken
.