Open Graph для видео

--- metadata: - name: generator content: Diplodoc Platform v5.42.1 alternate: - https://yandex.uz/support/video/ru/partners/open-graph.md - https://yandex.uz/support/video/uz/partners/open-graph.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.uz/support/video/ru/llms.txt # Разметка Open Graph для видео ## Проверка разметки {#test} Для проверки соответствия разметки нашим требованиям вы можете воспользоваться [валидатором](https://webmaster.yandex.ru/tools/microtest/). Обращаем внимание, что он не проверяет ваши страницы на полное соответствие стандарту [Open Graph Protocol](http://ogp.me/), а лишь тестирует наличие достаточной информации для индексирования вашего видео. ## Минимальный пример разметки {#markup} Ниже перечислены все свойства разметки видео, обрабатываемые роботом Яндекса. #| || **Свойство** | **Тип** | **Описание** || || og:title | [String](http://ogp.me/#string) | Название видео. Максимальная длина — 1000 символов, более длинный текст обрезается. || || og:url | [URL](http://ogp.me/#url) | Канонический путь к странице, например: `https://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, WEBP. || || 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 может выглядеть так: ``` ``` ## Дополнительная разметка {#optional} Перечисленные ниже поля необязательны к заполнению, но их наличие позволит лучше индексировать ваши видеоролики и выдавать их по релевантным запросам пользователей. [Формат видео](#format-video) [Категории видео](#category) [Параметры плеера](#player) [Формат даты](#date) [Статистика](#stat) [Ограничения показа](#restrictions) [Разметка дублей](#duplicate) ### Формат видео {#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`), предполагает дополнительные поля, характеризующие его. {% cut "Фильм (video.movie)" %} Если для элемента og:type указано значение `video.movie`, видео можно дополнительно описать следующими полями: - `ya:ovs:original_name` — название фильма на языке производителя. - `video:release_date` — дата выхода фильма. - `ya:ovs:movie:part` — номер части (для фильмов из нескольких частей, например «Гарри Поттер и Дары смерти: Часть 1»). {% endcut %} {% cut "Серия сериала (video.episode)" %} Поддерживаемые характеристики: - `ya:ovs:episode` (обязательное поле) — номер эпизода. - `ya:ovs:original_name` — название эпизода на языке производителя. - `video:release_date` — дата выхода серии в эфир. - `ya:ovs:season` — номер сезона, к которому относится эпизод. {% endcut %} {% cut "Музыкальное видео (ya:ovs:music)" %} Поддерживаемые характеристики: - `ya:ovs:track_name` (обязательное поле) — название трека. - `ya:ovs:album` — название альбома, в который входит трек. {% endcut %} {% cut "Выпуск шоу (video.tv_show)" %} Поддерживаемые характеристики: - `ya:ovs:episode` (обязательное поле) — номер выпуска телешоу. - `video:release_date` — дата выхода выпуска телешоу. - `ya:ovs:season` — номер сезона, к которому относится выпуск. {% endcut %} {% cut "Прямая трансляция (ya:ovs:broadcast)" %} Поддерживаемые характеристики: - `ya:ovs:start_date` (обязательное поле) — дата и время начала трансляции. - `ya:ovs:end_date` — дата и время окончания трансляции (не указывается, если по окончании трансляции запись доступна по тому же адресу. {% endcut %} ### Параметры плеера {#player} Поддерживаемые характеристики: - `ya:ovs:allow_embed` — признак того, что видео можно показывать на странице результатов поиска Яндекса. ``` ``` - `og:video:type` — доступные кодеки для данного формата видео. - `ya:ovs:available_platform` — платформа, на которой можно воспроизвести данное видео. Пример списка поддерживаемых платформ: ``` ``` {% cut "Полный список поддерживаемых значений" %} - Desktop — указание на то, что поддерживаются основные платформы персональных компьютеров (перечислены ниже) - Windows - Linux - OSX - Mobile — указание на то, что поддерживаются основные мобильные платформы (перечислены ниже) - iOS - Android - WindowsPhone - WindowsMobile - Symbian - Bada - BlackBerry - MeeGo {% endcut %} ### Формат даты {#date} Дату и время следует указывать согласно стандарту [ISO 8601](https://ru.wikipedia.org/wiki/ISO_8601), в формате YYYY-MM-DDTHH:mm:ss+035:00, где: - YYYY — год - MM — месяц - DD — день - HH — час - mm — минута - ss — секунда - +0: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` вы можете указать возрастные ограничения на показ видео. ### Разметка дублей {#duplicate} Дубли видеороликов предоставляют возможность выбора между версиями с разным языком, качеством и субтитрами. Чтобы добавить дубли, используйте свойство `ya:ovs:duplicate`. Можно добавить до 10 дублей. Пример разметки, когда у видео два дубля: ``` ``` Яндекс объединяет одинаковые видео с разных видеохостингов в один документ, позволяя выбрать предпочтительный источник для воспроизведения. Подробнее см. в разделе [Объединение дублей видео](https://yandex.uz/support/video/ru/doubles.md) ## Свойства, которые поддерживает поиск по видео {#primeropisanijavideo} Ниже перечислены свойства разметки видео, обрабатываемые роботом Яндекса. #| || **Свойство** | **Тип** | **Описание** || || **Обязательные** {.cell-align-center} | > | > || || og:title | [String](http://ogp.me/#string) | Название видео. Максимальная длина — 1000 символов, более длинный текст обрезается. || || og:url | [URL](http://ogp.me/#url) | Канонический путь к странице, например: `https://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, WEBP. || || 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) | Доступные кодеки для данного формата видео. || || **Дополнительные** {.cell-align-center} | > | > || || 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). || || ya:ovs:embed_region_allowed | [String](https://ogp.me/#string) | По аналогии с `og:restrictions:country:allowed`, но только для роботов Яндекса. || || ya:ovs:embed_region_disallowed | [String](http://ogp.me/#string) | По аналогии с `og:restrictions:country:disallowed`, но только для роботов Яндекса. || || 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: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/robot-workings/check-yandex-robots.html), чтобы разрешить скачивание только роботу Яндекса. || || 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/Жанры_игрового_кино#primeropisanijavideoD0.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/ISO_639-1). || || 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/ISO_639-1). || || 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) | Участник видео с указанием его роли в создании видео. Следует указать, кем является данный человек — актером, режиссером, продюсером, исполнителем и т. п. {% cut "Cписок поддерживаемых профессий" %} Задавая элемент `ovs:person`, в значении атрибута `role` можно указывать как узбекские, так и английские названия профессий. - Автор текстов (Songwriter) - Актер (Actor) - Актер дубляжа (Dubbing mixer) - Аранжировщик (Arranger) - Барабанщик (Drummer) - Бас-гитарист (Bass guitar player) - Ведущий (Host) - Вокалист (Vocalist) - Директор картины (Executive producer) - Директор по подбору актеров (Casting director) - Дирижёр (Conductor) - Дублёр (Body double) - Звукооператор (Sound engineer) - Звукорежиссер (Sound designer) - Исполнитель на акустической гитаре (Acoustic guitar player) - Исполнитель на электрогитаре (Electric guitarist) - Исполнитель трюков (Stunt performer) - Клавишник (Keyboardist) - Композитор (Composer) - Консультант (Сonsultant) - Костюмер (Costume supervisor) - Оператор (Camera operator) - Оператор-постановщик (Camera director) - Осветитель (Gaffer) - Парикмахер (Hair stylist) - Помощник режиссера (Stage manager) - Постановщик трюков (Stunt coordinator) - Продюсер (Producer) - Редактор (Editor) - Режиссер монтажа (Film editor) - Режиссер-постановщик (Film director) - Ритм-гитарист (Rhythm guitarist) - Скрипач (Violinist) - Сценарист (Script writer) - Художник-постановщик (Production designer) - Художник по костюмам (Costume designer) {% endcut %} || || ya:ovs:production_company | [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 ... ```

Написать в службу поддержки