Требования к данным
Чтобы подключиться к поиску по видео Mail.ru вам нужно предоставить поток обновлений:
- ссылку на RSS-поток с обновлениями;
- данные о видеороликах в формате XML;
- ссылку на описание API сервиса (для крупных партнеров).
Подключение с использованием формата XML
Для взаимодействия с Поиском Видео Mail.ru в формате XML, необходимо подготовить скрипт, который будет отдавать данные по протоколу HTTP.
Для того чтобы избежать проблем с полнотой индексации, рекомендуем реализовать в скрипте обработку параметров from и to, позволяющих задать период времени, за который требуются данные. Параметры from и to, а также даты в XML должны быть заданы в следующем формате:
год-месяц-день[Тчас:минута:секунда[Z|+час[:]минута]]
Примеры:
- 2012-12-01
- 2012-12-01T05:01:25
- 2012-12-01T05:01:25Z – по Гринвичу
- 2012-12-01T05:01:25+04:00 – Московское время
- 2012-12-01T05:01:25+02:00 – Украинское зимнее время
Пример запроса к вашему скрипту:
//video.test.ru/export.xml?from=2012-11-07T00:00:00Z&to=2012-11-08T00:05:00Z
XML фид должен содержать информацию о добавлении, обновлении, удалении роликов.
Про обновляемые, также как и про новые ролики фид должен содержать полную информацию. Ролик следует считать обновившимся при обновлении любых его полей из фида (можно не учитывать количество комментариев, рейтинг, количество голосов, количество просмотров).
Чем полнее и точнее информация о ролике, тем лучше он ранжируется.
| XML | Описание |
| <?xml version="1.0" encoding="utf-8"?> | Заголовок XML. Кодировка по умолчанию utf-8. |
| <hosting xmlns="//go.mail.ru/schemas/video/1.0" from="2007-01-01T00:00:00+04:00" to="2012-12-01T00:00:00+04:00" site="//video.test.ru" sitename="ОбоВсемВидео"> |
Корневой тег. xmlns – пространство имен XML Поиска Видео Mail.ru; from, to – период времени, данные за который содержатся в XML; site – URL хостинга; sitename – Название хостинга |
| <videoset> | Массив разделов <video> |
| <video id="78557"> | Раздел данных ролика (добавление или обновление ролика) id – Уникальный идентификатор ролика |
| <url>//video.test.ru/4621/17/play</url> | URL ролика |
| <name><![CDATA[Треугольные мотивы]]></name> | Название ролика |
| <preview>//media.test.ru/4621/17.jpg</preview> | URL превью ролика |
| <duration>415</duration> | Длительность. Опционально. |
| <date>2012-03-14T19:11:00+03:00</date> | Дата загрузки на хостинг. Рекомендуем указывать часовой пояс. Опционально. |
| <description><![CDATA[Вяжем треугольную салфетку крючком]]></description> | Описание ролика. Опционально. |
| <tags><![CDATA[Вязание крючком, Салфетка, Фрактал]]></tags> | Тэги ролика через «,» или «;». Опционально. |
| <category>Хобби</category> | Категория ролика. Опционально. |
| <adult>no</adult> | Ролик «для взрослых». yes/no. Опционально. |
| <visibility>free</visibility> | Доступность ролика. Допустимые значения: free – свободно, login – только для зарегистрированных пользователей Опционально. |
| <author>ws</author> | Имя автора ролика (или пользователя, загрузившего ролик). Опционально. |
| <author_url>//www.test.ru/ws/</author_url> | URL странички автора. Опционально. |
| <hits>1502</hits> | Количество просмотров ролика. Целое неотрицательное число. Опционально. |
| <comments>21</comments> | Количество комментариев к ролику. Целое неотрицательное число. Опционально. |
| <rating>4.8</rating> | Рейтинг ролика по шкале хостинга. Неотрицательное число. Опционально. |
| <votes>47</votes> | Количество голосов пользователей, по которым посчитан рейтинг. Целое неотрицательное число. Опционально. |
| <hd>yes</hd> | Ролик доступен в хорошем качестве (720p или лучше). yes/no. Опционально. |
| <shooting_date>2012-03-14T13:05:00+03:00</shooting_date> | Дата съёмки. Рекомендуем указывать часовой пояс. Опционально. |
| <paid>yes</paid> | Ролик доступен только для платного просмотра. yes/no. Опционально. |
| <fee>1 RUB</fee> | Размер взноса для просмотра ролика. Положительное число и буквенное обозначение валюты по ISO4217. Опционально. |
| </video> | |
| ... | |
| <video id="271129" delete="1" /> | Удаление ролика по ID |
| <video> <url>//video.test.ru/4603/59/play</url> <deleted /> </video> |
Удаление ролика по URL |
| </videoset> | |
| </hosting> |
Спецсимволы в значениях полей следует экранировать, либо использовать CDATA.
Формат XML фидов Поиска Видео Mail.ru (по состоянию на 1 декабря 2012) совместим с форматом XML фидов Яндекс.Видео.
XML-данные, передаваемые партнером, и индексация данных Mail.ru не гарантирует показа роликов на определенных местах в Поиске и осуществляется на безвозмездной основе.
Передача данных по RSS
Если у вас уже имеется RSS-поток, содержащий информацию о ваших видео, то мы можем подключить его и добавлять ролики в наш Поиск.
Предпочтительный формат – Media RSS.
Могут быть рассмотрены и другие диалекты RSS, при условии, что в них есть необходимые данные. Абсолютный минимум данных – Название, URL ролика, URL превью.
Проблема с RSS подключение в том, что мы не сможем закачать информацию о более старых материалах, только о новинках. Также мы не сможем оперативно понять, какие ролики были удалены с хостинга, а значит их удаление займет больше времени. В связи с этим передача данных в xml выглядит предпочтительнее.
RSS-трансляция данных партнером и индексация данных Mail.ru не гарантирует показа роликов на определенных местах в Поиске и осуществляется на безвозмездной основе.