---
metadata:
- name: generator
content: Diplodoc Platform v5.54.2
alternate:
- https://yandex.ru/support/webmaster/en/video/open-graph.md
- https://yandex.ru/support/webmaster/ru/video/open-graph.md
- href: ru/video/open-graph.md
type: text/markdown
title: Markdown version
- href: ../llms.txt
type: text/markdown
title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/webmaster/ru/llms.txt
# Разметка Open Graph для видео
## Минимальный пример разметки {#markup}
Ниже перечислены все свойства разметки видео, обрабатываемые роботом Яндекса.
#|
||
**Свойство**
|
**Тип**
|
**Описание**
||
||
og:title
|
[String](http://ogp.me/#string)
|
Название видео.
Максимальная длина — 1000 символов, более длинный текст обрезается.
||
||
og:url
|
[URL](http://ogp.me/#url)
|
Канонический путь к странице, например: `http://myhost.ru/video.html`.
||
||
og:video
|
[URL](http://ogp.me/#url)
|
Путь к видеоплееру или файлу.
||
||
og:image
|
[URL](http://ogp.me/#url)
|
URL заставки видео.
Минимальный размер — 352 × 198 пикселей.
Рекомендованный размер — 564 × 318 пикселей.
Допустимые форматы — JPG, PNG и GIF.
||
||
og:description
|
[String](http://ogp.me/#string)
|
Описание видео.
Рекомендуемый объем описания видео 150-1000 символов.
||
||
ya:ovs:upload_date
|
[DateTime](http://ogp.me/#datetime)
|
Дата загрузки видео в формате [ISO 8601](#date).
||
||
ya:ovs:adult
|
[Boolean](http://ogp.me/#bool)
|
Признак контента с возрастным ограничением 18+.
Чтобы отметить видео для взрослых, укажите значение «true». Если возрастное ограничение не требуется, укажите значение «false».
||
||
video:duration
|
[Integer](http://ogp.me/#integer)
|
Длительность видео в секундах с округлением до целого числа.
||
||
og:type
|
[String](http://ogp.me/#string)
|
[Категория видео](#category).
Некоторые категории могут требовать дополнительные поля для описания видео.
||
||
og:video:type
|
[String](http://ogp.me/#string)
|
Доступные кодеки для данного формата видео.
||
|#
Некоторые данные необходимы для корректного индексирования видеоролика. Минимальное описание видео в разметке Open Graph может выглядеть так:
```
```
## Добавление плеера {#add-player}
{% note info %}
В настоящее время в поиск Яндекса по видео встраиваются плееры крупных хостингов, в базе которых есть не менее 1 000 роликов.
{% endnote %}
Чтобы ваш плеер попал в результаты поиска по видео, сообщите о нем роботу Яндекса одним из способов:
- Разместите плеер на отдельной странице и разрешите воспроизводить видео в результатах поиска Яндекса. Для этого добавьте элемент `ya:ovs:allow_embed` со значением `true`.
```
```
- Передайте HTML-код для встраивания вашего плеера с помощью элемента `ya:ovs:embed_html`.
```
```
После того, как вы укажите плеер в разметке, напишите нам об этом через [форму обратной связи](https://yandex.ru/support/video/troubleshooting/for-webm.html). Мы протестируем плеер и сообщим вам о результатах.
## Дополнительная разметка {#optional}
Перечисленные ниже поля необязательны к заполнению, но их наличие позволит лучше индексировать ваши видеоролики и выдавать их по релевантным запросам пользователей.
### Формат видео {#format-video}
Поддерживаются следующие поля:
- `og:video:width` — ширина видео в пикселях.
- `og:video:height` — высота видео в пикселях.
- `ya:ovs:bitrate` — максимальный битрейт, в килобитах в секунду (kbps).
- `ya:ovs:quality` — качество кодирования видео.
Поддерживаемые значения:
- `low` — низкое качество (разрешение меньше 360 × 640, битрейт ниже 717 kbps);
- `medium` — среднее качество (разрешение от 360 × 640 до 720 × 1280, битрейт от 717 kbps до 1 Mbps);
- `HD` — HD-качество (разрешение от 720 × 1280 до 1080 × 1920, битрейт 1-2 Mbps);
- `full HD` — качество 1080p (разрешение больше 1080 × 1920, битрейт выше 2 Mbps).
### Категории видео {#category}
Каждый тип видео, указанный в поле `og:type` (кроме типа `other`), предполагает дополнительные поля, характеризующие его.
#### Фильм (video.movie) {#movie}
Если для элемента og:type указано значение `video.movie`, видео можно дополнительно описать следующими полями:
- `ya:ovs:original_name` — название фильма на языке производителя.
- `video:release_date` — дата выхода фильма.
- `ys:ovs:movie:part` — номер части (для фильмов из нескольких частей, например «Гарри Поттер и Дары смерти: Часть 1»).
#### Серия сериала (video.episode) {#series}
Поддерживаемые характеристики:
- `ya:ovs:episode` (обязательное поле) — номер эпизода.
- `ya:ovs:original_name` — название эпизода на языке производителя.
- `video:release_date` — дата выхода серии в эфир.
- `ya:ovs:season` — номер сезона, к которому относится эпизод.
#### Музыкальное видео (ya:ovs:music) {#music-video}
Поддерживаемые характеристики:
- `ya:ovs:track_name` (обязательное поле) — название трека.
- `ya:ovs:album` — название альбома, в который входит трек.
#### Выпуск шоу (video.tv_show) {#show}
Поддерживаемые характеристики:
- `ya:ovs:episode` (обязательное поле) — номер выпуска телешоу.
- `video:release_date` — дата выхода выпуска телешоу.
- `ya:ovs:season` — номер сезона, к которому относится выпуск.
#### Прямая трансляция (ya:ovs:broadcast) {#broadcast}
Поддерживаемые характеристики:
- `ya:ovs:start_date` (обязательное поле) — дата и время начала трансляции.
- `ya:ovs:end_date` — дата и время окончания трансляции (не указывается, если по окончании трансляции запись доступна по тому же адресу.
### Параметры плеера {#player}
Поддерживаемые характеристики:
- `ya:ovs:allow_embed` — признак того, что видео можно показывать на странице результатов поиска Яндекса.
```
```
- `ya:ovs:embed_html` — HTML-код для вставки плеера, проигрывающего видео.
- `og:video:type` — доступные кодеки для данного формата видео.
- `ya:ovs:available_platform` — платформа, на которой можно воспроизвести данное видео.
Пример списка поддерживаемых платформ:
```
```
Полный список поддерживаемых значений:
- Desktop — указание на то, что поддерживаются основные платформы персональных компьютеров (перечислены ниже)
- Windows
- Linux
- OSX
- Mobile — указание на то, что поддерживаются основные мобильные платформы (перечислены ниже).
- iOS
- Android
- WindowsPhone
- WindowsMobile
- Symbian
- Bada
- BlackBerry
- MeeGo
### Формат даты {#date}
Дату и время следует указывать согласно стандарту [ISO 8601](http://ru.wikipedia.org/wiki/ISO_8601), в формате YYYY-MM-DDTHH:mm:ss+03:00, где:
- YYYY — год
- MM — месяц
- DD — день
- HH — час
- mm — минута
- ss — секунда
- +03:00 — часовой пояс (в данном случае московское время).
Если вы хотите указать только год (например, в качестве даты выхода фильма), укажите полночь 1 января в нужном году, например, 2001-01-01T00:00:00.
Пример разметки:
```
```
### Статистика {#stat}
Статистику просмотров и рейтингов видео можно описать с помощью следующих элементов:
- `ya:ovs:views_last_day` — число просмотров видео за последний день.
- `ya:ovs:views_last_month` — число просмотров за последний месяц.
- `ya:ovs:views_last_week` — число просмотров видео за последнюю неделю.
- `ya:ovs:views_total` — общее число просмотров видео.
- `ya:ovs:comments` — общее количество отзывов на видео.
- `ya:ovs:likes` — общее число пользователей, которым понравилось видео.
- `ya:ovs:dislikes` — общее число пользователей, которым не понравилось видео.
- `ya:ovs:rating` — усредненный рейтинг видео (по целой шкале от 0 до 10).
Пример разметки:
```
```
### Ограничения показа {#restrictions}
Ограничения на показ видео задаются с помощью тегов `og:restrictions`.
**Международные ограничения**
: С помощью элементов og:restrictions:country:allowed и og:restrictions:country:disallowed вы можете точно указать ограничения на международные показы видео:
- Элемент `og:restrictions:country:allowed` рекомендуется использовать, если видео разрешено показывать только в определенных странах.
- Элемент `og:restrictions:country:disallowed` рекомендуется использовать, если показ видео ограничен только в некоторых странах. Совместное использование этих двух элементов приведет к ошибке.
Страны следует указывать в формате [ISO 3166-1](https://ru.wikipedia.org/wiki/ISO_3166-1#.D0.A1.D0.BF.D0.B8.D1.81.D0.BE.D0.BA_.D0.BA.D0.BE.D0.B4.D0.BE.D0.B2_.D0.BF.D0.BE_ISO_3166). Несколько ограничений можно перечислить через запятую или указать в отдельных элементах.
**Возрастные ограничения**
: С помощью элемента og:restrictions:age вы можете указать возрастные ограничения на показ видео.
### Платный доступ к просмотру видео {#price}
Поддерживаемые характеристики:
- `ya:ovs:price:rate` — стоимость видео (в соответствии с типом оплаты).
- `ya:ovs:price` — тип оплаты видео.
Поддерживаемые значения:
- `rent` — право на просмотр в течение ограниченного времени,
- `subscription` — подписка на серию роликов или на длительный срок,
- `purchase` — приобретение видео,
- `currency` — валюта в формате [ISO 4217](https://ru.wikipedia.org/wiki/ISO_4217).
- `duration`— продолжительность (для платы за период времени) в формате [ISO 8601](#date).
## Свойства, которые поддерживает поиск Яндекса по видео {#primeropisanijavideo}
Ниже перечислены свойства разметки видео, обрабатываемые роботом Яндекса.
#|
||
**Свойство**
|
**Тип**
|
**Описание**
||
||
og:title
|
[String](http://ogp.me/#string)
|
Название видео.
Максимальная длина — 1000 символов, более длинный текст обрезается.
||
||
og:url
|
[URL](http://ogp.me/#url)
|
Канонический путь к странице, например: `http://myhost.ru/video.html`.
||
||
og:video
|
[URL](http://ogp.me/#url)
|
Путь к видеоплееру или файлу.
||
||
og:image
|
[URL](http://ogp.me/#url)
|
URL заставки видео.
Минимальный размер 120х90 пикселей. Допустимые форматы — JPG, PNG и GIF.
||
||
og:description
|
[String](http://ogp.me/#string)
|
Описание видео.
Рекомендуемый объем описания видео от 150 до 1000 символов.
||
||
ya:ovs:upload_date
|
[DateTime](http://ogp.me/#datetime)
|
Дата загрузки видео в формате [ISO 8601](#date).
||
||
ya:ovs:adult
|
[Boolean](http://ogp.me/#bool)
|
Признак контента с возрастным ограничением 18+.
Чтобы отметить видео для взрослых, укажите значение «true». Если возрастное ограничение не требуется, укажите значение «false».
||
||
video:duration
|
[Integer](http://ogp.me/#integer)
|
Длительность видео в секундах с округлением до целого числа.
||
||
og:type
|
[String](http://ogp.me/#string)
|
[Категория видео](#category).
Некоторые категории могут требовать дополнительные поля для описания видео.
||
||
og:video:type
|
[String](http://ogp.me/#string)
|
Доступные кодеки для данного формата видео.
||
||
**Дополнительные**
||
||
ya:ovs:content_id
|
[String](http://ogp.me/#string)
|
Идентификатор видео, который должен быть уникальным для каждого видео.
Одно и то же видео, размещенное на разных страницах, должно иметь один и тот же идентификатор в разметке этих страниц. Таким образом робот сможет избежать индексирования дубликатов.
||
||
ya:ovs:status
|
[Enum](http://ogp.me/#enum)
|
Состояние, в котором находится видео.
Несколько статусов можно перечислить через запятую или указать в нескольких тегах ``.
Поддерживаемые значения поля:
- `published` — опубликовано.
- `blocked` — заблокировано.
- `private` — защищено настройками приватности.
- `processing` — обрабатывается.
- `deleted` — удалено.
||
||
ya:ovs:login
|
[String](http://ogp.me/#string)
|
Имя пользователя, загрузившего видео.
||
||
ya:ovs:is_official
|
[Boolean](http://ogp.me/#bool)
|
Признак видео, размещенного на официальном сайте или канале производителя, исполнителя или правообладателя.
Чтобы указать, что видео официальное, задайте поле со значением «true». Если поля `ya:ovs:is_official` в фиде нет, Яндекс сочтет видео неофициальным.
||
||
ya:ovs:license
|
[Enum](http://ogp.me/#enum)
|
Тип лицензии на видеоконтент.
Поддерживаемые значения:
- «cc» — лицензия Creative Commons
- «commercial» — коммерческая лицензия
||
||
og:restrictions:country:allowed
|
[String](http://ogp.me/#string)
|
Список стран, в которых разрешен показ данного видео.
Подробнее см. в разделе [Ограничение показов](#restrictions).
||
||
og:restrictions:country:disallowed
|
[String](http://ogp.me/#string)
|
Список стран, в которых показ данного видео запрещен или ограничен.
Подробнее см. в разделе [Ограничение показов](#restrictions).
||
||
og:restrictions:age
|
[String](http://ogp.me/#string)
|
Возрастные ограничения для данного видео.
Подробнее см. в разделе [Ограничение показов](#restrictions).
||
||
ya:ovs:available_platform
|
[Enum](http://ogp.me/#enum)
|
Платформа, на которой можно воспроизвести данное видео.
Пример списка поддерживаемых платформ:
```
```
{% cut "Полный список поддерживаемых значений" %}
- Desktop — указание на то, что поддерживаются основные платформы персональных компьютеров (перечислены ниже)
- Windows
- Linux
- OSX
- Mobile — указание на то, что поддерживаются основные мобильные платформы (перечислены ниже).
- iOS
- Android
- WindowsPhone
- WindowsMobile
- Symbian
- Bada
- BlackBerry
- MeeGo
{% endcut %}
||
||
og:video:width
|
[Integer](http://ogp.me/#integer)
|
Ширина видео в пикселях.
||
||
og:video:height
|
[Integer](http://ogp.me/#integer)
|
Высота видео в пикселях.
||
||
ya:ovs:bitrate
|
[Integer](http://ogp.me/#integer)
|
Максимальный битрейт, в килобитах в секунду (kbps).
||
||
ya:ovs:quality
|
[Enum](http://ogp.me/#enum)
|
Качество кодирования видео.
Поддерживаемые значения:
- `low` — низкое качество (разрешение меньше 360 × 640, битрейт ниже 717 kbps);
- `medium` — среднее качество (разрешение от 360 × 640 до 720 × 1280, битрейт от 717 kbps до 1 Mbps);
- `HD` — HD-качество (разрешение от 720 × 1280 до 1080 × 1920, битрейт 1-2 Mbps);
- `full HD` — качество 1080p (разрешение больше 1080 × 1920, битрейт выше 2 Mbps).
||
||
ya:ovs:allow_embed
|
[Boolean](http://ogp.me/#bool)
|
Признак того, что видео можно показывать на странице результатов поиска Яндекса.
По умолчанию видео можно проигрывать прямо в результатах поиска. Чтобы видео можно было посмотреть только на вашем сайте, задайте поле так:
``` ```
||
||
ya:ovs:embed_html
|
[String](http://ogp.me/#string)
|
HTML-код для вставки плеера, проигрывающего видео.
||
||
ya:ovs:content_url
|
[URL](http://ogp.me/#url)
|
URL видеофайла.
Допускаются любые форматы видео — .mpg, .mpeg, .mp4, .m4v, .mov, .wmv, .asf, .avi, .ra, .ram, .rm, .flv и так далее.
Роботу Яндекса необходим доступ к видеофайлу для извлечения и актуализации дополнительной информации о видео. Если вы запретили публичный доступ к файлу, рекомендуем воспользоваться [обратным DNS-запросом](https://yandex.ru/support/webmaster/ru/robot-workings/check-yandex-robots.md), чтобы разрешить скачивание только роботу Яндекса.
||
||
ya:ovs:content_url:public
|
[Boolean](http://ogp.me/#bool)
|
Признак публичности видео.
Доступные значения:
- `true` — видеофайл могут скачивать пользователи
- `false` — видеофайл может скачать только поисковый робот, для автоматизированного анализа видеопотока
||
||
ya:ovs:category
|
[String](http://ogp.me/#string)
|
Категория видео («музыка», «фильм», «сериал» и т. п.).
||
||
ya:ovs:genre
|
[String](http://ogp.me/#string)
|
Жанр видео, в свободной форме (рок, драма, пародия).
Вы можете указать несколько жанров, через запятую или в отдельных элементах `genre`. Списки популярных жанров можно найти в статьях Википедии, посвященных [жанрам игрового кино](https://ru.wikipedia.org/wiki/Жанры_игрового_кино#.D0.A2.D0.B0.D0.B1.D0.BB.D0.B8.D1.86.D0.B0_.D0.B6.D0.B0.D0.BD.D1.80.D0.BE.D0.B2_.D0.B8.D0.B3.D1.80.D0.BE.D0.B2.D0.BE.D0.B3.D0.BE_.D0.BA.D0.B8.D0.BD.D0.BE) и [музыкальным жанрам](https://ru.wikipedia.org/wiki/%D1%EF%E8%F1%EE%EA_%EC%F3%E7%FB%EA%E0%EB%FC%ED%FB%F5_%E6%E0%ED%F0%EE%E2,_%ED%E0%EF%F0%E0%E2%EB%E5%ED%E8%E9_%E8_%F1%F2%E8%EB%E5%E9).
||
||
video:tag
|
[String](http://ogp.me/#string)
|
Ключевые слова (теги), характеризующие видео.
Теги можно перечислять через запятую, либо указывать в отдельных элементах.
||
||
ya:ovs:languages
|
[String](http://ogp.me/#string)
|
Список языков, для которых в видео присутствуют звуковые дорожки.
Несколько языков можно перечислить через запятую или указать в отдельных элементах. Языки следует указывать в формате [ISO 639-1](https://ru.wikipedia.org/wiki/%CA%EE%E4%FB_%FF%E7%FB%EA%EE%E2#.D0.A2.D0.B0.D0.B1.D0.BB.D0.B8.D1.86.D0.B0_.D1.81_.D0.BA.D0.BE.D0.B4.D0.B0.D0.BC.D0.B8_.D1.8F.D0.B7.D1.8B.D0.BA.D0.BE.D0.B2_.D0.BF.D0.BE_.D0.93.D0.9E.D0.A1.D0.A2_7.75-97).
||
||
ya:ovs:dubbing
|
[String](http://ogp.me/#string)
|
Название студии дубляжа.
||
||
ya:ovs:subtitle
|
[URL](http://ogp.me/#url)
|
Ссылка на файл субтитров на определенном языке.
||
||
ya:ovs:subtitle:language
|
[String](http://ogp.me/#string)
|
Язык субтитров в формате [ISO 639-1](https://ru.wikipedia.org/wiki/%CA%EE%E4%FB_%FF%E7%FB%EA%EE%E2#.D0.A2.D0.B0.D0.B1.D0.BB.D0.B8.D1.86.D0.B0_.D1.81_.D0.BA.D0.BE.D0.B4.D0.B0.D0.BC.D0.B8_.D1.8F.D0.B7.D1.8B.D0.BA.D0.BE.D0.B2_.D0.BF.D0.BE_.D0.93.D0.9E.D0.A1.D0.A2_7.75-97).
||
||
ya:ovs:price
|
[Enum](http://ogp.me/#enum)
|
[Тип оплаты видео](#price).
||
||
ya:ovs:price:duration
|
[DateTime](http://ogp.me/#datetime)
|
Продолжительность оплаты (за период времени) в формате [ISO 8601](#date).
||
||
ya:ovs:price:rate
|
[Integer](http://ogp.me/#integer)
|
Стоимость видео (соответственно типу оплаты в поле `ya:ovs:price`).
||
||
ya:ovs:price:currency
|
[String](http://ogp.me/#string)
|
Валюта, в которой указана [стоимость видео](#price) (в формате [ISO 4217](https://ru.wikipedia.org/wiki/ISO_4217)).
||
||
ya:ovs:feed_url
|
[URL](http://ogp.me/#url)
|
Адрес, по которому можно получить актуальные метаданные о видео.
Может совпадать с адресом страницы видео, при наличии достаточно полной семантической разметки.
||
||
ya:ovs:views_last_day
|
[Integer](http://ogp.me/#integer)
|
Число просмотров видео за последний день.
||
||
ya:ovs:views_last_month
|
[Integer](http://ogp.me/#integer)
|
Число просмотров за последний месяц.
||
||
ya:ovs:views_last_week
|
[Integer](http://ogp.me/#integer)
|
Число просмотров видео за последнюю неделю.
||
||
ya:ovs:views_total
|
[Integer](http://ogp.me/#integer)
|
Общее число просмотров видео.
||
||
ya:ovs:comments
|
[Integer](http://ogp.me/#integer)
|
Общее количество отзывов на видео.
||
||
ya:ovs:likes
|
[Integer](http://ogp.me/#integer)
|
Общее число пользователей, которым понравилось видео.
||
||
ya:ovs:dislikes
|
[Integer](http://ogp.me/#integer)
|
Общее число пользователей, которым не понравилось видео.
||
||
ya:ovs:rating
|
[Integer](http://ogp.me/#integer)
|
Усредненный рейтинг видео (по целой шкале от 0 до 10).
||
||
ya:ovs:person
|
[String](http://ogp.me/#string)
|
Имя человека, участвовавшего в съемке видео.
||
||
ya:ovs:person:role
|
[String](http://ogp.me/#string)
|
Участник видео с указанием его роли в создании видео.
Следует указать, кем является данный человек — актером, режиссером, продюсером, исполнителем и т. п.
||
||
ya:ovs:production_coumpany
|
[String](http://ogp.me/#string)
|
Компания, создавшая видео.
||
||
ya:ovs:country
|
[String](http://ogp.me/#string)
|
Страна, в которой было создано видео.
Несколько стран можно перечислить через запятую или указать в отдельных элементах. Страны следует указывать в формате [ISO 3166-1](https://ru.wikipedia.org/wiki/ISO_3166-1#.D0.A1.D0.BF.D0.B8.D1.81.D0.BE.D0.BA_.D0.BA.D0.BE.D0.B4.D0.BE.D0.B2_.D0.BF.D0.BE_ISO_3166).
||
||
ya:ovs:poster
|
[URL](http://ogp.me/#url)
|
Ссылка на изображение обложки альбома, постера фильма и т. п.
Несколько изображений можно указать в нескольких элементах `poster`. Минимальный размер изображения — 256×360. Поддерживаются форматы JPG, PNG и GIF.
||
||
ya:ovs:created_date
|
[DateTime](http://ogp.me/#datetime)
|
Дата создания видео в формате [ISO 8601](#date).
||
||
ya:ovs:modify_date
|
[DateTime](http://ogp.me/#datetime)
|
Дата изменения видео в формате [ISO 8601](#date).
||
||
ya:ovs:expiration_date
|
[DateTime](http://ogp.me/#datetime)
|
Дата истечения срока прав на видеоконтент в формате [ISO 8601](#date).
Не следует указывать, если права на видео не имеют срока действия.
||
|#
## Пример подробного описания видео {#all-properties_1}
```xml
...
```
{% cut "Написать в службу поддержки" %}
{% endcut %}
Также вы можете перейти на сервис
[](https://webmaster.yandex.ru/) [](https://webmaster.yandex.ru/)