В примерах ниже показано, как выполнять различные типы поисковых запросов в API версии 3.
Видео
В этом примере вызывается метод search.list, чтобы найти самые популярные видео в высоком разрешении (HD), связанные с запросом "собака на скейтборде". Запрос задает параметры order, part, q, type и videoDefinition.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &order=viewCount &q=skateboarding+dog &type=video &videoDefinition=high
Примеры кода можно найти в документации по методу search.list.
Плейлисты
В этом примере показано, как найти плейлисты, соответствующие запросу "GoogleDevelopers". Он вызывает метод search.list и задает для параметра type значение playlist, чтобы в наборе результатов были только плейлисты.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=GoogleDevelopers &type=playlist
Каналы
В этом примере показано, как найти каналы, соответствующие запросу "travel". Он вызывает метод search.list и задает для параметра type значение channel, чтобы в наборе результатов были только каналы.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=travel &type=channel
Результаты на определенном языке
В этом примере вызывается метод search.list, чтобы найти результаты поиска, наиболее подходящие для определенного языка. В примере показано, что поисковый запрос – marine (q=marine), а ответ API должен содержать результаты, наиболее релевантные для французского языка (relevanceLanguage=fr).
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=marine &relevanceLanguage=fr
Обратите внимание, что в запросе не задано значение параметра type, а значит, каждый результат поиска может относиться к видео, плейлисту или каналу.
Видео, загруженные через приложение или сайт разработчика.
В этом примере показано, как использовать параметр forDeveloper, чтобы ограничить поиск и получить только видео, загруженные через приложение или сайт разработчика. Этот параметр можно использовать вместе с необязательными параметрами поиска, например q.
Примечание. Этот запрос не возвращает результаты в API Explorer, поскольку API Explorer не поддерживает загрузку видео. Вы можете выполнить этот запрос для своего приложения вне API Explorer, но не сможете получить результаты для своего приложения с помощью API Explorer.
Каждому загруженному видео автоматически присваивается тег с номером проекта, связанного с приложением разработчика в консоли Google Cloud.
Когда в поисковом запросе параметру forDeveloper присваивается значение true, сервис API использует учетные данные авторизации запроса для идентификации разработчика. Таким образом, разработчик может ограничить результаты видео, загруженными через его собственное приложение или сайт, но не видео, загруженными через другие приложения или сайты.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=fun &forDeveloper=true