Загрузка контента на видеохостинг и выгрузка контентного фида

Минимальный пример разметки

В таблице перечислены свойства из пространства имен ovs, без которых видеоролики проиндексированы не будут. Непосредственно в XML-коде фида имена элементов должны предваряться указанием пространства имен, например ovs:content_id или ovs:title.

СвойствоТипОписание
thumbnail

url

URL заставки видео. Минимальный размер изображения — 120х90 пикселей. Допустимые форматы — JPG, PNG и GIF.

Это обязательно должна быть ссылка на http:// или https://, перекодированная в URL-encoding и содержащая имя домена и адрес, по которому можно скачать картинку. IP-адреса в ссылке не поддерживаются.

title

string

Название ролика.

Максимальная длина — 1000 символов, более длинный текст обрезается.

description

string

Описание ролика.

upload_date

Timestamp

Дата формирования фида в формате Unix Timestamp.

release_date

Timestamp

Дата создания контента в формате Unix Timestamp.

сontent_id

string

Идентификатор видео. Должен быть уникальным для каждого ролика. Идентификатор может быть указан в виде текста, числа или хэш-кода.
content_url

url

URL видеофайла в формате .mp4 с кодеком h264/AAC.

Это обязательно должна быть ссылка на http:// или https://, перекодированная в URL-encoding и содержащая имя домена и адрес, по которому можно скачать видео. IP-адреса в ссылке не поддерживаются.

age

string

Возрастное ограничение контента. Указывается по действующему законодательству РФ в формате <возраст>+. Например, 0+ или 12+. Ответственность за корректность простановки возрастного ограничения несет правообладатель.

Стандартный заголовок документа должен выглядеть так:

<?xml version="1.0" encoding="UTF-8"?>

В корневом элементе ovs:video укажите пространство имен и ссылку на XML-схему, как показано в примере. Каждое видео должно быть описано в отдельном элементе ovs:video.

<?xml version="1.0" encoding="UTF-8"?>
<ovs:video 
    xmlns:ovs="https://webmaster.yandex.ru/schemas/video"
    xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="https://webmaster.yandex.ru/schemas/video">
  <ovs:url>https://www.mysite.com/page123</ovs:url>
  <ovs:thumbnail>https://www.mysite.com/default.jpg</ovs:thumbnail>
  <ovs:title>Что такое XML?</ovs:title>
  <ovs:description>XML — это современная технология представления данных. 
  Сегодня XML очень распространен в самых разных областях: с его помощью
  формируются документы различных типов, XML часто используется для обмена
  данными в программировании, для передачи информации в интернете. 
  Gредлагаемый курс рассматривает основные технологии XML, такие как описание
  данных, грамматика XML-разметки, XML схемы, XSL и XSLT.</ovs:description>
  <ovs:upload_date>1526308089</ovs:upload_date>
  <ovs:release_date>1526307080</ovs:release_date>
  <ovs:content_id>ff174856</ovs:content_id>
  <ovs:content_url> https://www.mysite.com/xmlvideo.mp4</ovs:content_url>
</ovs:video>

Дополнительная разметка

Перечисленные ниже поля необязательны к заполнению, но их наличие позволит лучше индексировать ваши видеоролики и выдавать их по релевантным запросам пользователей.

Категории видео

В значении элемента category можно указать категорию, к которой относится данное видео. Рекомендуемые Яндексом категории и соответствующие значения перечислены ниже. Если подходящей категории в списке нет, вы можете придумать собственную категорию и задать подходящее значение.

Доступные категории
  • Авто-мото (auto_moto).

  • Анимация (animation).

  • Вебинары (webinars).

  • Вебкамеры (webcams).

  • Дом, семья, дети (home_family_kids).

  • Животные (animals).

  • Здоровье (health).

  • Игры (games).

  • Интервью (interview).

  • Интернет (internet).

  • Искусство (art).

  • История (history).

  • Караоке (karaoke).

  • Катастрофы и происшествия (disasters_and_accidents).

  • Клип (clip).

  • Концерт (concert).

  • Короткое видео (short_video).

  • Красота и мода (beauty_and_fashion).

  • Кулинария (recipe).

  • Музыка и видеоклипы (music).

  • Мультфильмы (cartoons).

  • Наука (science).

  • Новости (news).

  • Образование (education).

  • Пародия (parody).

  • Политика (politics).

  • Природа (nature).

  • Программы (software).

  • Прямые трансляции (broadcast).

  • Путешествия (travel).

  • Развлечения (entertainment).

  • Реклама (commercial).

  • Сад и огород (Gardening).

  • Сделай сам (handmade).

  • Слайдшоу (slideshow).

  • Спорт (sport).

  • Стиль жизни (lifestyle).

  • Танцы (dancing).

  • ТВ (TV).

  • Телесериалы (tvseries).

  • Телешоу (tvshow).

  • Технологии (gadget).

  • Товары (goods).

  • Трейлер (trailer).

  • Увлечения (hobby).

  • Фильмы (movie).

  • Фильм о фильме (movie_about_movie).

  • Фрагмент (fragment).

Вы можете указать несколько категорий в отдельных элементах. Например, чтобы обозначить, что речь идет о концертной записи.

Пример разметки:

<ovs:category>movie</ovs:category>
<ovs:category>trailer</ovs:category>

Для некоторых категорий видео доступна дополнительная разметка:

Серия сериала (ovs:tvseries)

Поддерживаемые характеристики:

  • ovs:episode (обязательное поле) — номер эпизода.
  • ovs:season — номер сезона.
  • ovs:serial_name — название сериала.
  • ovs:season_name — название сезона.
  • ovs:episode_name — название серии.
  • ovs:episode_description — описание серии.
  • ovs:serial_thumbnail — URL заставки сериала.
  • ovs:season_thumbnail — URL заставки сезона.
  • ovs:serial_description — описание сериала.
  • ovs:season_description — описание сезона.

Пример разметки:

<ovs:tvseries>
  <ovs:season_number>1</ovs:season_number>
  <ovs:episode_number>1</ovs:episode_number>
  <ovs:serial_name>Маша и Медведь</ovs:serial_name>
  <ovs:episode_name>Первая встреча</ovs:episode_name>
  <ovs:season_name>Первые встречи</ovs:season_name>
  <ovs:serial_thumbnail>http://mysite.com/mm/1234.png</ovs:serial_thumbnail>
  <ovs:season_thumbnail> http://mysite.com/mm/s1/1234.png</ovs:serial_thumbnail>
  <ovs:serial_description>Маша — невероятно активная девочка, которая никогда не сидит 
  на месте и считает, что весь мир создан для неё одной. Машина индивидуальность 
  не знает границ, поэтому урок труда легко оборачивается строительством парусного 
  корабля, а набор художника — в разукрашивание всего леса.</ovs:serial_description>
  <ovs:season_description>В первом сезоне вы познакомитесь с девочкой Машей и большим 
  добрым медведем, увидите, как зарождалась их дружба</ovs:season_description>
  <ovs:episode_description>Далеко-далеко, в домике возле железной дороги, живет 
  маленькая и очень шустрая девочка Маша. Она так любит играть, что прочие обитатели 
  двора от нее просто прячутся. От скуки непоседа убегает в лес, где находится уютный
  домик Медведя, который в этот момент как раз ушел на рыбалку. Вернувшись домой, 
  Медведь находит свое жилье в разрушенном состоянии. Он обнаруживает источник 
  беспорядков в самом домике — это прыгающая на кровати маленькая девочка. Медведь 
  всячески пытается избавиться от незваной гостьи. Но когда ему это удается, он вдруг 
  испытывает тревогу за судьбу оставленной в лесу Маши. Медведь бросается на поиски 
  и находит ее в своем доме. </ovs:episode_description>
</ovs:tvseries>
Музыкальное видео (ovs:music)

Поддерживаемые характеристики:

  • ovs:track_name (обязательное поле) — название трека.

  • ovs:album — название альбома.

Пример разметки:

<ovs:music>
  <track_name>A Bar In Amsterdam</track_name>
  <album>Le Pop</album>
</ovs:music>

Для дополнительного описания видео можно использовать только одну из этих категорий (например, нельзя одновременно использовать элементы ovs:movie и ovs:tvshow). Указывать дополнительные элементы необязательно — если подробных данных о видео нет, просто задайте нужное значение для элемента ovs:category.

Жанры видео

Жанры видео указываются по желанию правообладателя каждый в отдельном поле.
<ovs:genre>Комедия</ovs:genre>
<ovs:genre>Драма</ovs:genre>
Список поддерживаемых значений
  • аниме
  • биография
  • боевик
  • вестерн
  • военный детектив
  • детский
  • для взрослых
  • документальный
  • драма
  • игра
  • история
  • комедия
  • концерт
  • короткометражка
  • криминал
  • мелодрама
  • музыка
  • мультфильм
  • мюзикл
  • новости
  • обучающее видео
  • приключения
  • реальное ТВ
  • семейный
  • спорт
  • ток-шоу
  • триллер
  • ужасы
  • фантастика
  • фильм-нуар
  • фэнтези

Формат даты

Дату и время следует указывать согласно стандарту Unix Timestamp.

Для преобразования даты и времени в формат Unix Timestamp можно использовать программный или онлайн конвертер.

Пример разметки:

<ovs:release_date>1526308089</ovs:release_date>

Ограничение распространения контента

Ограничения прописываются в элементе ovs:restrictions.

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

Пример разметки:

<ovs:restrictions>
   <ovs:restriction allow="yes" country="ru" platform=”Windows”/>
   <ovs:restriction allow="yes" country="ru" platform=”iOS”/>        
</ovs:restrictions>
Список платформ
  • Desktop — указание на то, что поддерживаются основные платформы персональных компьютеров (Windows, OSX, Linux)

  • Windows

  • Linux

  • OSX

  • Mobile — указание на то, что поддерживаются основные мобильные платформы (перечислены ниже).

  • iOS

  • Android

  • WindowsPhone

  • SmartTV

  • Set-top-box

Фид для вставки плеера

Чтобы получить ссылки на видео, загруженное в плеер Яндекса, вы можете выгрузить обратный фид, в котором внутри элемента ovs:embed_url будет указана ссылка вида:

<ovs:embed_url>https://frontend.vh.yandex.ru/player/445b39ba987ac4d8a0fba2db71086b68?from=partner</ovs:embed_url>

Этот код iframe с плеером вы можете вставить на свой сайт.

Свойства, которые поддерживает контентный фид

В таблице перечислены свойства из пространства имен ovs. Непосредственно в XML-коде фида имена элементов должны предваряться указанием пространства имен, например ovs:content_id или ovs:title.

СвойствоТипОписание
Обязательные
thumbnail

url

URL заставки видео. Минимальный размер изображения 120х90 пикселей. Допустимые форматы — JPG, PNG и GIF.

Это обязательно должна быть ссылка на http:// или https://, перекодированная в URL-encoding и содержащая имя домена и адрес, по которому можно скачать картинку. IP-адреса в ссылке не поддерживаются.

title

string

Название ролика. Максимальная длина — 1000 символов, более длинный текст обрезается.

description

string

Описание ролика.

upload_date

Timestamp

Дата формирования фида в формате Unix Timestamp.
release_dateTimestampДата создания контента.
content_id

string

Идентификатор видео.

Должен быть уникальным для каждого видео. Идентификатор может быть указан в виде текста, числа или хэш-кода.

content_url

url

URL видеофайла в формате .mp4 с кодеком h264/AAC.

Это обязательно должна быть ссылка на http:// или https://, перекодированная в URL-encoding и содержащая имя домена и адрес, по которому можно скачать видео. IP-адреса в ссылке не поддерживаются.

age

string

Возрастное ограничение контента. Указывается по действующему законодательству РФ в формате <возраст>+. Например, 0+ или 12+. Ответственность за корректность простановки возрастного ограничения несет правообладатель
Дополнительные
duration

unsignedInt

Длительность видео в секундах с округлением до целого числа. Необходимо только для выгрузки. При загрузке фида игнорируется.

allow_embedstring

Признак того, что видео можно показывать в плеере Яндекса и на сайтах-партнерах Рекламной сети Яндекса.

По умолчанию видео можно проигрывать на сайтах-партнерах РСЯ. Чтобы видео можно было смотреть только на сервисах Яндекса, передайте в элементе ovs:allow_embed значение no.

restrictionsstring

Разрешение или запрет на показ видео в указанных территориях и/или платформах. Заполняется в отдельных элементах ovs:restriction.

Пример разметки:
<ovs:restriction allow="yes" country="ru" platform=”Windows”/>
<ovs:restriction allow="yes" country="ru" platform=”iOS”/>
category

string

Категория видео (музыка, фильм, сериал и т. д.).

Можно указать несколько категорий в отдельных элементах ovs:category.

introduce_dateTimestamp

Дата начала срока прав на видеоконтент в формате Unix Timestamp.

Не указывается, если права на видео не имеют срока действия.

expiration_dateTimestamp

Дата окончания срока прав на видеоконтент в формате Unix Timestamp.

Не указывается, если права на видео не имеют срока действия.

genre

string

Жанр видео (аниме, документальный и т. д.).

Можно указать несколько жанров в отдельных элементах ovs:genre.

poster

url

Ссылка на изображение обложки альбома, постера фильма и т. п.

Это обязательно должна быть ссылка на http:// или https://, перекодированная в URL-encoding и содержащая имя домена и адрес, по которому можно скачать картинку. IP-адреса в ссылке не поддерживаются.

Несколько изображений можно указать в нескольких элементах poster.

Минимальный размер изображения — 256×360. Картинка должна быть строго вертикальной. Поддерживаются форматы JPG, PNG и GIF.

tag

string

Ключевые слова (теги), характеризующие видео.

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

Пример подробного описания видео

<?xml version="1.0" encoding="UTF-8"?>
<ovs:video 
  xmlns:ovs="https://webmaster.yandex.ru/schemas/video" 
  xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="https://webmaster.yandex.ru/schemas/video">
  <ovs:content_id>1</ovs:content_id>
  <ovs:content_url>https://www.mysite.com/video.mp4</ovs:content_url>
  <ovs:thumbnail>https://www.mysite.com/default.jpg</ovs:thumbnail>
  <ovs:title>Что такое XML?</ovs:title>
  <ovs:description>XML — это современная технология представления данных.
  Сегодня XML очень распространен в самых разных областях: с его помощью
  формируются документы различных типов, XML часто используется для обмена
  данными в программировании, для передачи информации в интернете.
  Предлагаемый курс рассматривает основные технологии XML, такие как описание
  данных, грамматика XML-разметки, XML схемы, XSL и XSLT.</ovs:description>
  <ovs:upload_date>1526897303</ovs:upload_date>
  <ovs:release_date>1526872512</ovs:upload_date>
  <ovs:duration>200</ovs:duration>
  <ovs:age>16+</ovs:age>
  <ovs:category>education</ovs:category>
  <ovs:category>internet</ovs:category>
  <ovs:genre>Обучающее видео</ovs:genre>
  <!-- Показ видео разрешен только в России на платформах iOS и Windows. -->
  <ovs:restriction allow="yes" country="ru" platform=”Windows”/>
  <ovs:restriction allow="yes" country="ru" platform=”iOS”/> 
  <!-- Плеер для вставки (обратный фид) -->
  <ovs:embed_url>https://www.mysite.com/iframe/yacinema/123/</ovs:embed_url>
</ovs:video>