Работа с Youtube API

Параметры для формирования запросов к Youtube API

Поиск видео

В этом разделе рассказывается о том, как использовать API для получения списка видео, соответствующих пользовательским критериям поиска. Для поиска видео, направьте запрос HTTP GET на этот URL, добавив к запросу подходящие параметры:

http://gdata.youtube.com/feeds/api/videos

Это запрос для поиска второго десятка недавно добавленных видео, соответствующих критерию «football», но не соответствующих критерию «soccer»:

http://gdata.youtube.com/feeds/api/videos?
    vq=football+-soccer
    &orderby=published
    &start-index=11
    &max-results=10

Запросы поиска могут включать любой из нижеследующих параметров. Часто используемые параметры перечислены первыми.

Название Определение
vq Параметр vq определяет критерий поиска. YouTube ищет все метаданные видео для видео, соответствующих критерию. Метаданные видео включают названия, ключевые слова, описания, имена пользователей-авторов и категории.

Заметьте, что все пробелы, кавычки и другие знаки препинания в значении параметра должны быть переведены в URL.

Для поиска точной фразы, включите ее в кавычки. Например, для поиска видео, соответствующих фразе «spy plane» (самолет-шпион), установите параметр vq на значение %22spy+plane%22.

В запросе можно применять логические операторы NOT (-) и OR (|), для того, чтобы исключить видео или найти видео, связанные с одним из нескольких критериев. Например, для поиска видео, соответствующих «boating» или «sailing» (хождение на веслах или под парусами), установите параметр vq на значение boating%7Csailing. (Заметьте, что символ вертикальной черты должен быть переведен в URL.) Таким же образом, для поиска видео, соответствующих «boating» или «sailing», но не «fishing», установите параметрvq на «boating&7Csailing+-fishing».

orderby Параметр orderby указывает значение, которое используется для сортировки видео в наборе результатов. Возможные значения – relevance, published, viewCount и rating (соответствие, дата публикации, количество просмотров, оценка). Кроме того, можно делать запрос на результаты, наиболее подходящие для определенного языка, выставив значение параметра relevance_lang_languageCode, где languageCodeдвухбуквенный код языка по ISO 639-1. (Для упрощенного китайского используется значение zh-Hans и для традиционного – zh-Hant.) Также, заметьте, что будут возвращены и результаты на других языках, если он имеют высокое соответствие критерию поиска. Значение по умолчанию — relevance.
start-index Параметр start-index указывает порядковый номер первого результата, включаемого в набор результатов. В этом параметре первый порядковый номер – 1, то есть первый результат – 1, второй – 2 и так далее. Параметр работает вместе с параметром max-results, определяя, какие результаты возвращать. Например, для того, чтобы получить вторую порцию в 25 результатов, т.е. результаты 26-50, параметр start-index устанавливается как 26, параметр max-results как 25.
max-results Параметр max-results указывает наибольшее число результатов, которые должны быть включены в набор. Этот параметр работает вместе с параметром start-index. Например, для того, чтобы получить вторую порцию в 25 результатов, т.е. результаты 26-50, параметр start-index устанавливается как 25, параметр max-results как 26. Значение по умолчанию – 25, а максимальное значение – 50.
author Параметр author ограничивает поиск видео, добавленными определенным пользователем YouTube..
alt Параметр alt указывает формат канала. Возможные значения – atom, rss, json и json-in-script. Значение по умолчанию – atom; в этом документе описывается только формат ответов Atom.
format Параметр format указывает, что видео должны быть в определенном формате. Запрос может указывать любой из этих форматов:

Значение Форматы видео
1 Потоковый URL RTSP для воспроизведения мобильного видео. Видео H.263 (до 176×144) и звук AMR.
5 URL HTTP на встраиваемый проигрыватель (SWF) для этого видео. Формат доступен только для встраиваемого видео. Разработчики часто добавляют к запросам &format=5, чтобы ограничить результаты теми видео, которые можно встроить на свой сайт.
6 Потоковый URL RTSP для воспроизведения мобильного видео. Видео MPEG-4 SP (до 176×144) и аудио AAC.
lr Параметр lr ограничивает поиск видео, имеющих определенный язык названия, описания или ключевых слов. Значения параметра lrдвухбуквенный код языка по ISO 639-1. Для упрощенного китайского используется значение zh-Hans и для традиционного – zh-Hant.
racy Параметр racy позволяет включать в результаты содержание с ограниченным доступом. Возможные значения – include и exclude. По умолчанию, содержание с ограниченным доступом исключено. В каналах видео, содержащие содержание с ограниченным доступом, будут содержать дополнительный элемент <yt:racy>.
restriction Параметр restriction определяет адрес IP, который следует использовать для отбора видео, которые можно воспроизводить только в определенных странах. По умолчанию, API отбрасывает видео, которые нельзя проигрывать в стране, из которой отправляются запросы. Это ограничение основано на адресе IP вашего клиентского приложения.Для запроса видео, которые можно воспроизводить на конкретном компьютере, включите в запрос параметр ограничения и установите его значение на адрес IP этого компьютера, например, restriction=255.255.255.255.

Для запроса видео, которые можно воспроизводить в определенной стране, включите в запрос параметр ограничения и установите его значение на двухбуквенный код этой страны по ISO 3166, например, restriction=DE.

time Параметр time, доступный только для стандартных каналов top_rated и most_viewed, ограничивает поиск видео, добавленными за определенное время. Допустимые значения для этого параметра — today (1 день), this_week (7 дней), this_month (1 месяц) and all_time. Значение по умолчанию – all_time.

Заметьте, что параметры запроса поиска можно использовать и с другими запросами к каналам. Например, можно получать видео, добавленные определенным пользователем, которые также соответствуют какому-нибудь ключевому слову.

Оригинал здесь
2.33 avg. rating (54% score) - 3 votes

One Comment

  • Ищу обзоры телефонов, к названию телефона добавляю «обзор», но все равно в основном на английском обзоры попадаются, хотя на самом сайте ютуба, первая и вторая страница только с ру обзорами, по этому же запросу.

    Подскажите как искать чтобы результаты в основном на русском были.
    все перепробовал
    regionCode=RU
    hl=ru
    gl=RU

    полный урл
    ttps://www.googleapis.com/youtube/v3/search?part=snippet&q=$search&maxResults=30&key=fhtrhtr

css.php