Реализация: Поисковые запросы

В следующих примерах показано, как выполнить несколько различных типов поисковых запросов в 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

каналы

В этом примере показано, как найти каналы, соответствующие запросу "путешествия". Он вызывает метод search.list и устанавливает значение параметра type равным channel , чтобы набор результатов включал только каналы. 

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=travel
        &type=channel

Результаты, относящиеся к определенному языку

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

Каждое загружаемое видео автоматически помечается номером проекта, который связан с приложением разработчика в Google API Console .

Когда поисковый запрос впоследствии устанавливает для параметра forDeveloper значение true, служба API использует учетные данные авторизации запроса для идентификации разработчика. Таким образом, разработчик может ограничить результаты видео, загруженными через собственное приложение или веб-сайт разработчика, но не видео, загруженными через другие приложения или сайты.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=fun
        &forDeveloper=true