Параметры для формирования запросов к 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 указывает, что видео должны быть в определенном формате. Запрос может указывать любой из этих форматов:
|
||||||||
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, например, |
||||||||
time | Параметр time, доступный только для стандартных каналов top_rated и most_viewed, ограничивает поиск видео, добавленными за определенное время. Допустимые значения для этого параметра — today (1 день), this_week (7 дней), this_month (1 месяц) and all_time. Значение по умолчанию – all_time. |
Заметьте, что параметры запроса поиска можно использовать и с другими запросами к каналам. Например, можно получать видео, добавленные определенным пользователем, которые также соответствуют какому-нибудь ключевому слову.
Оригинал здесь
One Comment
Ищу обзоры телефонов, к названию телефона добавляю «обзор», но все равно в основном на английском обзоры попадаются, хотя на самом сайте ютуба, первая и вторая страница только с ру обзорами, по этому же запросу.
Подскажите как искать чтобы результаты в основном на русском были.
все перепробовал
regionCode=RU
hl=ru
gl=RU
полный урл
ttps://www.googleapis.com/youtube/v3/search?part=snippet&q=$search&maxResults=30&key=fhtrhtr