Владельцам фотохостингов

Яндекс.Картинки приглашают к сотрудничеству фотохостинги

Мы предлагаем владельцам фотохостингов сообщать нам информацию об изменениях, происходящих на их фото-ресурсах, в виде данных в формате XML или Media RSS. Это дает следующие преимущества:

• Скорость индексирования. Фотографии будут попадать в поиск Яндекс.Картинок гораздо быстрее, чем это происходит при обычном индексировании фотохостинга.
• Качество индексирования. Структурированные данные в формате XML более точно описывают фотографии, чем тексты, извлекаемые со страниц фотогалерей (фотоальбомов) роботом Яндекса. Это позволяет обеспечить более качественный поиск.
• Полнота и актуальность данных. Обновление данных об изменениях на фотохостинге происходит с необходимой для вас частотой. Это позволяет оперативно добавлять информацию о новых фотографиях, удалять старые и изменять описания существующих, что сделает более полным их представление в результатах поиска Яндекс.Картинок.
• Рост трафика. Благодаря более точному и полному индексированию пользователи Яндекс.Картинок смогут быстрее и проще находить интересные фотографии, что приведет к увеличению количества посетителей вашего фотохостинга.

Требования к фотографиям

Мы индексируем фотографии, которые:

• имеют формат JPEG, GIF или PNG;
• сопровождаются текстовыми описаниями в виде названий, авторских комментариев, ключевых слов (тэгов) или подписанных фрагментов фотографий (меток);
• представлены в свободном доступе в открытых альбомах для просмотра всем незарегистрированным пользователям фотохостинга.

Мы не допускаем индексацию фотографий с фотохостингов, которые:

• не обеспечивают необходимую модерацию фотографий и альбомов;
• содержат материалы оскорбительной и/или порнографической направленности;
• допускают размещение фотографий с нарушением требований действующего законодательства Российской Федерации;
• не отвечают условиям «Лицензии на использование поисковой системы Яндекса».

Требования к формату XML-файла

Чтобы получить возможность передавать данные в Яндекс.Картинки через XML, необходимо подготовить CGI-скрипт, формирующий XML-данные об обновлениях базы фотохостинга в формате, описанном ниже. Скрипт должен обрабатывать два параметра — from и to, позволяющих задать период времени, за который требуются данные. Формат параметров from и to, а также данных о дате/времени внутри XML-файла, имеет вид:

год-месяц-день[Tчас:минута:секунда[Z|+час[:]минута]]

Примеры:

2007-07-28
2007-07-28T15:45:23        // указано местное время
2007-07-28T15:45:23Z        // время указано по Гринвичу
2007-07-28T15:45:23+05:00   // указано местное время для «+5»-го часового пояса

При обращении к скрипту в параметрах from и to время указывается по Гринвичу. Внутри XML-файла можно использовать любой из приведенных выше форматов, однако использовать местное время без указания часового пояса не рекомендуется.

Кроме информации о новых альбомах и фотографиях, в XML-файле должна передаваться актуальная информация:

• об удаленных альбомах и фотографиях;
• об изменениях в текстовых описаниях альбомов и фотографий;
• об изменениях статусов альбомов и фотографий, связанных с ограничением доступа, модерацией или иными действиями пользователей и администраторов фотохостинга.

<?xml version="1.0" encoding="windows-1251"?>

<hosting xmlns="http://images.yandex.ru/schemas/img_import"
              from="2001-01-01"
              to="2007-08-10T20:15:44+03:00"
              site="http://fotki.yandex.ru/ "
              sitename="Яндекс.Фотки">

<imgset> 

<img id="123456"> 

<src>
    http://img-fotki.yandex.ru/get/1/petrov/123456_orig
</src> 

<location>
    http://fotki.yandex.ru/users/petrov/view/123456/
</location> 

<name>Я на солнышке лежу</name>

<description>
На пляже в Сочи во время летнего отпуска
</description>

<tags>
море,пляж,отпуск,сочи,центральная набережная, прогулочный катер
</tags> 

<author name="petrov" id="1234">
    http://fotki.yandex.ru/users/petrov/
</author> 

<gallery name="Отпуск в Сочи" id="1234_12">
    http://fotki.yandex.ru/users/petrov/album/12/
</gallery> 

<created>2007-08-10</created> 

<phototime>2007-07-28T15:45:23+05:00</phototime> 

<adult>no</adult> 

<path>Путешествия/Россия/Море</path> 

<rating>174</rating> 

<hits>352</hits> 

<originalfrom>
    http://petrov.narod.ru/images/sochi_123.jpg
</originalfrom> 

</img> 

...

<img id="234567" delete="1" /> 

...

<img> 

<src>
    http://img-fotki.yandex.ru/get/1/petrov/234567_orig
</src> URL удаляемой фотографии. <delete /> 

</img> 

...

</imgset> 

<authorset> 

<author id="2345" delete="1" /> 

<author delete="1">
    http://fotki.yandex.ru/users/sidorov/
</author> 

...

 </authorset> 

<galleryset> 

<gallery id="2345_23" delete="1" /> 

<gallery delete="1">
    http://fotki.yandex.ru/users/sidorov/album/23/
</gallery> 

...

</galleryset> 
</hosting>

Обработка ошибок

Выполнение следующих правил позволит избежать ошибок индексирования, связанных со сбоями в процессе XML-импорта.

Если при работе скрипта, формирующего XML-файл, произошел сбой, сервер должен вернуть стандартный код ошибки HTTP-протокола, например:

• 500 — Internal Server Error
• 501 — Not Implemented
• 503 — Service Unavailable

Если в процессе формирования XML-файла ошибка произошла уже после отправки ответа "200 — OK", рекомендуется сразу оборвать передачу данных, по возможности завершив процесс сообщением об ошибке (в произвольной форме). В этом случае не следует формировать правильный (валидный) XML-файл, для чего достаточно не передать закрывающий тег </hosting>. Неправильный формат XML-файла считается признаком ошибки, и переданные в нем данные не будут внесены в индексную базу Яндекс.Картинок.

Media RSS

Мы поддерживаем импорт данных в формате Media RSS. Если у вас уже есть RSS-поток с обновлениями, то мы можем его использовать. В этом случае от фотохостинга не требуется создание дополнительных скриптов.

Как начать импорт

Пришлите нам заявку на подключение фотохостинга к XML-импорту или сообщите адрес RSS-потока на xml-import@images.yandex.ru.

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

Мы оставляем за собой право отклонить заявку без объяснения причин.