Технические требования к трансляции отзывов об организациях с помощью XML-фида

Требования к XML-фиду

  1. Транслируемые данные должны быть опубликованы на сайте клиента по URL, согласованному с Яндексом, и доступны по протоколу HTTP. Если планируется изменить URL, необходимо уведомить об этом Яндекс не менее чем за три рабочих дня до внесения изменений.
  2. Большие объемы данных рекомендуется публиковать в виде архива GNU zip (расширение gz).
  3. Чтобы снизить создаваемую роботом нагрузку на ваш сайт и сократить время попадания новых данных в выдачу на сервисе, рекомендуем воспользоваться одним из HTTP-заголовков — ETag или Last-Modified. Это позволит роботу сравнить текущую версию XML-файла с последней загруженной версией.
  4. С одного партнерского сайта можно передавать только один XML-файл, в который может быть включено любое количество данных по разным объектам.
  5. На сервисах Яндекса будут показываться только те отзывы, которые есть в последней версии XML-файла (каждый раз фид полностью перезагружается). Если какой-либо отзыв был удален из фида, он также будет удален из сервисов Яндекса.
  6. Партнер обязуется передавать максимальный набор элементов и параметров для каждого отзыва. В файле должны отображаться все параметры, указанные на странице отзыва на сайте Партнера.
  7. Передаваемые данные должны соответствовать спецификации формата, описанного ниже.
  8. В данных не должно быть HTML-тегов. В стандарте XML не допустимы символы с ASCII-кодами в диапазоне значений от 0 до 31 в текстовых полях. Исключением являются значения 9, 10, 13 — табуляция, перевод строки, возврат каретки. Также этот стандарт строго требует заменять в тексте все следующие символы:
    Символ, который необходимо заменить Код для XML-файла
    " "
    & &
    > >
    < &lt;
    ' &apos;
  9. Допускается защитить подготовленный XML-фид паролем. В таком случае необходимо будет прислать пароль к файлу на адрес info@reviews.yandex.ru.

При подготовке файла мы рекомендуем использовать валидатор XML-фидов.

Формат передаваемых данных

Передаваемые данные должны быть оформлены с помощью разметки XML:

  1. URL отзыва в фиде должен быть закодирован в соответствии со стандартом RFC 1738.
  2. В XML-фиде запрещено использовать теги DOCTYPE.
  3. Фид может быть представлен в любой кодировке (рекомендуется кодировка UTF-8).
  4. Фид должен содержать стандартный XML-заголовок, который должен начинаться с первой строки, с нулевого символа.

    Например:
    <?xml version="1.0" encoding="UTF-8"?>
  5. Фид должен содержать сложный элемент <reviews>. Данный элемент должен состоять из последовательных элементов отзывов <review>, отдельно содержащих следующую информацию:
    • информацию об объекте отзыва,
    • сам отзыв,
    • оцениваемые параметры отзыва,
    • данные об авторе отзыва.

    Подробное описание для составляющих элементов приведено ниже.

Пример подробной XSD-схемы
    <xs:element name="reviews">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="review" type="BizReview" minOccurs="1" maxOccurs="unbounded"/>
            </xs:sequence>
        </xs:complexType>
    </xs:element>

    <xs:complexType name="BizReview">
        <xs:all>
            <xs:element name="url" type="xs:anyURI">
                <xs:annotation>
                    <xs:documentation>
                        URL отзыва.
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
            <xs:element name="mobile-url" type="xs:anyURI" minOccurs="0">
                <xs:annotation>
                    <xs:documentation>
                        URL отзыва на мобильной версии сайта.
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
            <xs:element name="type" type="xs:string" fixed="biz">
                <xs:annotation>
                    <xs:documentation>
Тип объекта отзыва. Для отзывов об организациях нужно указать значение «biz».
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
            <xs:element name="reviewer" type="Reviewer" minOccurs="1">
                <xs:annotation>
                    <xs:documentation>
                        Обязательный элемент с данными об авторе отзыва.
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
            <xs:element name="item" type="Item" minOccurs="1">
                <xs:annotation>
                    <xs:documentation>
                        Обязательный элемент с описанием объект отзыва.
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
            <xs:element name="locale" type="Locale">
                <xs:annotation>
                    <xs:documentation>
Язык, на котором написан отзыв. Для отзывов на русском языке следует указывать значение «ru».
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
            <xs:element name="summary" type="xs:string" minOccurs="0">
                <xs:annotation>
                    <xs:documentation>
                        Краткая аннотация к отзыву.
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
            <xs:element name="description" type="xs:string" minOccurs="0">
                <xs:annotation>
                    <xs:documentation>
                        Текст отзыва.
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
            <xs:element name="pros" minOccurs="0">
                <xs:annotation>
                    <xs:documentation>
                        Список достоинств объекта отзыва.
                    </xs:documentation>
                </xs:annotation>
                <xs:complexType>
                    <xs:sequence>
                        <xs:element name="pro" type="xs:string" minOccurs="1" maxOccurs="unbounded"/>
                    </xs:sequence>
                </xs:complexType>
            </xs:element>
            <xs:element name="contras" minOccurs="0">
                <xs:annotation>
                    <xs:documentation>
                        Список недостатков объекта отзыва.
                    </xs:documentation>
                </xs:annotation>
                <xs:complexType>
                    <xs:sequence>
                        <xs:element name="contra" type="xs:string" minOccurs="1" maxOccurs="unbounded"/>
                    </xs:sequence>
                </xs:complexType>
            </xs:element>
            <xs:element name="rating" type="xs:decimal" minOccurs="0">
                <xs:annotation>
                    <xs:documentation>
Оценка автора (рейтинг) объекта отзыва в формате числа с фиксированной точкой (например, 4.0, 4.5 или 4). По умолчанию рейтинг считается от 1 до 5.
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
            <xs:element name="best-rating" type="xs:decimal" minOccurs="0">
                <xs:annotation>
                    <xs:documentation>
                        Верхняя граница шкалы рейтинга, если она отличается от 5.
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
            <xs:element name="worst-rating" type="xs:decimal" minOccurs="0">
                <xs:annotation>
                    <xs:documentation>
                        Нижняя граница шкалы рейтинга, если она отличается от 1.
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
            <xs:element name="tags" minOccurs="0">
                <xs:complexType>
                    <xs:sequence>
                        <xs:element name="tag" type="Tag" minOccurs="1" maxOccurs="unbounded"/>
                    </xs:sequence>
                </xs:complexType>
            </xs:element>
            <xs:element name="useful" type="xs:nonNegativeInteger" minOccurs="0">
                <xs:annotation>
                    <xs:documentation>
                        Число голосов «за» отзыв.
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
            <xs:element name="useless" type="xs:integer" minOccurs="0">
                <xs:annotation>
                    <xs:documentation>
                        Число голосов «против» отзыва.
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
            <xs:element name="likes" type="xs:nonNegativeInteger" minOccurs="0">
                <xs:annotation>
                    <xs:documentation>
                        Число «лайков» (благодарностей) от читатейлей за отзыв.
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
            <xs:element name="comments" type="xs:nonNegativeInteger" minOccurs="0">
                <xs:annotation>
                    <xs:documentation>
                        Число комментариев к отзыву.
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
            <xs:element name="dtreviewed" type="xs:dateTime">
                <xs:annotation>
                    <xs:documentation>
                        Дата написания отзыва в формате ISO 8601 (2005-08-09T18:31). Обязательный элемент.
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
            <xs:element name="dtvisited" type="xs:date" minOccurs="0">
                <xs:annotation>
                    <xs:documentation>
                        Дата посещения организации в формате ISO 8601 (2005-08-09T18:31).
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
            <xs:element name="reviewsurl" type="xs:anyURI" minOccurs="0">
                <xs:annotation>
                    <xs:documentation>
                        URL страницы, на которой собраны другие отзывы про эту организацию.
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
            <xs:element name="commenturl" type="xs:anyURI" minOccurs="0">
                <xs:annotation>
                    <xs:documentation>
                        URL страницы, на которой собраны комментарии к этому отзыву.
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
        </xs:all>
    </xs:complexType>

    <xs:simpleType name="RatedProperty">
        <xs:annotation>
            <xs:documentation>
                Оцениваемые параметры организации.
            </xs:documentation>
        </xs:annotation>
        <xs:restriction base="xs:string">
            <xs:enumeration value="cuisine">
                <xs:annotation>
                    <xs:documentation>
                        Качество кухни.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="service">
                <xs:annotation>
                    <xs:documentation>
                        Качество обслуживания.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="interior">
                <xs:annotation>
                    <xs:documentation>
                        Впечатление от интерьера.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="value-for-money">
                <xs:annotation>
                    <xs:documentation>
                        Соотношение цена/качество.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="hall">
                <xs:annotation>
                    <xs:documentation>
                        Качество зала (для кинотеатров).
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="movie-choice">
                <xs:annotation>
                    <xs:documentation>
                        Выбор фильмов (для кинотеатров).
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="accommodation">
                <xs:annotation>
                    <xs:documentation>
                        Впечатления от номера (для гостиниц).
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="location">
                <xs:annotation>
                    <xs:documentation>
                        Удобство месторасположения (для гостиниц).
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="drinks">
                <xs:annotation>
                    <xs:documentation>
                        Качество напитков.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="equipment">
                <xs:annotation>
                    <xs:documentation>
                        Качество оборудования (для фитнес клубов).
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="water-quality">
                <xs:annotation>
                    <xs:documentation>
                        Качество воды в бассейне.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="workmanship">
                <xs:annotation>
                    <xs:documentation>
                        Качество произведенных работ.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="music">
                <xs:annotation>
                    <xs:documentation>
                        Впечатления от музыки в заведении.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="cleanliness">
                <xs:annotation>
                    <xs:documentation>
                        Чистота заведения.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="bea_comfort">
                <xs:annotation>
                    <xs:documentation>
                        Комфорт в номере.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="internet">
                <xs:annotation>
                    <xs:documentation>
                        Качество интернет-соединения.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
        </xs:restriction>
    </xs:simpleType>

    <xs:complexType name="Tag">
        <xs:annotation>
            <xs:documentation>
                Оценка некоторого параметра организации.
            </xs:documentation>
        </xs:annotation>
        <xs:all>
            <xs:element name="value" type="xs:decimal" minOccurs="1">
                <xs:annotation>
                    <xs:documentation>
Значение оценки параметра организации. Число с фиксированной точкой (например, 4.0, 4.5 или 4).
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
            <xs:element name="name" type="RatedProperty" minOccurs="1">
                <xs:annotation>
                    <xs:documentation>
                        Оцениваемый параметр организации.
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
            <xs:element name="best" type="xs:decimal" minOccurs="0">
                <xs:annotation>
                    <xs:documentation>
                        Максимальное возможное значение оценки.
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
            <xs:element name="worst" type="xs:decimal" minOccurs="0">
                <xs:annotation>
                    <xs:documentation>
                        Минимальное возможное значение оценки.
                    </xs:documentation>
                </xs:annotation>
            </xs:element>
        </xs:all>
    </xs:complexType>

    <xs:complexType name="Reviewer">
        <xs:annotation>
            <xs:documentation>
                Тип, описывающий автора отзыва.
            </xs:documentation>
        </xs:annotation>
        <xs:sequence>
            <xs:element name="vcard">
                <xs:complexType>
                    <xs:all>
                        <xs:element name="fn" type="xs:string" minOccurs="0">
                            <xs:annotation>
                                <xs:documentation>
                                    Имя автора отзыва.
                                </xs:documentation>
                            </xs:annotation>
                        </xs:element>
                        <xs:element name="url" type="xs:anyURI" minOccurs="0">
                            <xs:annotation>
                                <xs:documentation>
                                    URL профиля автора на данном ресурсе.
                                </xs:documentation>
                            </xs:annotation>
                        </xs:element>
                        <xs:element name="email" type="xs:string" minOccurs="0">
                            <xs:annotation>
                                <xs:documentation>
                                    Адрес электронной почты автора.
                                </xs:documentation>
                            </xs:annotation>
                        </xs:element>
                        <xs:element name="avatar" type="xs:anyURI" minOccurs="0">
                            <xs:annotation>
                                <xs:documentation>
                                   URL, по которому расположен аватар автора на данном ресурсе.
                                </xs:documentation>
                            </xs:annotation>
                        </xs:element>
                        <xs:element name="thanks" type="xs:nonNegativeInteger" minOccurs="0">
                            <xs:annotation>
                                <xs:documentation>
                                    Число благодарностей автору от других пользователей.
                                </xs:documentation>
                            </xs:annotation>
                        </xs:element>
                        <xs:element name="authpost" type="xs:nonNegativeInteger" minOccurs="0">
                            <xs:annotation>
                                <xs:documentation>
                                    Число постов (не отзывов) автора на данном ресурсе.
                                </xs:documentation>
                            </xs:annotation>
                        </xs:element>
                        <xs:element name="authcomments" type="xs:nonNegativeInteger" minOccurs="0">
                            <xs:annotation>
                                <xs:documentation>
                                    Число комментариев автора.
                                </xs:documentation>
                            </xs:annotation>
                        </xs:element>
                        <xs:element name="friends" type="xs:nonNegativeInteger" minOccurs="0">
                            <xs:annotation>
                                <xs:documentation>
                                    Число "друзей" автора на данном ресурсе.
                                </xs:documentation>
                            </xs:annotation>
                        </xs:element>
                        <xs:element name="karma" type="xs:decimal" minOccurs="0">
                            <xs:annotation>
                                <xs:documentation>
                                    Рейтинг/карма/уровень доверия к автору.
                                </xs:documentation>
                            </xs:annotation>
                        </xs:element>
                    </xs:all>
                </xs:complexType>
            </xs:element>
        </xs:sequence>
    </xs:complexType>

    <xs:simpleType name="BizCategory">
        <xs:annotation>
            <xs:documentation>
                Категории организаций, на которые может быть оставлен отзыв.
            </xs:documentation>
        </xs:annotation>
        <xs:restriction base="xs:string">
            <xs:enumeration value="hospital">
                <xs:annotation>
                    <xs:documentation>
                        Лечебные учреждения.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="hotel">
                <xs:annotation>
                    <xs:documentation>
                        Гостиницы.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="restaurant">
                <xs:annotation>
                    <xs:documentation>
                        Кафе, рестораны, бары.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="maternity">
                <xs:annotation>
                    <xs:documentation>
                        Родильные дома.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="ISP">
                <xs:annotation>
                    <xs:documentation>
                        Интернет провайдеры.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="gas_station">
                <xs:annotation>
                    <xs:documentation>
                        АЗС.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="pharmacy">
                <xs:annotation>
                    <xs:documentation>
                        Аптеки.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="cinema">
                <xs:annotation>
                    <xs:documentation>
                        Кинотеатры.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="shopping">
                <xs:annotation>
                    <xs:documentation>
                        Магазины.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="notary">
                <xs:annotation>
                    <xs:documentation>
                        Нотариальные услуги.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="rink">
                <xs:annotation>
                    <xs:documentation>
                        Катки.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="night_club">
                <xs:annotation>
                    <xs:documentation>
                        Ночные клубы.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="bank">
                <xs:annotation>
                    <xs:documentation>
                        Банки.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="sauna">
                <xs:annotation>
                    <xs:documentation>
                        Бани и сауны.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="car_wash">
                <xs:annotation>
                    <xs:documentation>
                        Автомойки.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="kindergarten">
                <xs:annotation>
                    <xs:documentation>
                        Детские сады.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="car_service">
                <xs:annotation>
                    <xs:documentation>
                        Автосервисы, автотехцентры.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="tire_service">
                <xs:annotation>
                    <xs:documentation>
                        Шиномонтаж.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="bowling_club">
                <xs:annotation>
                    <xs:documentation>
                        Боулинг-клубы.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="school">
                <xs:annotation>
                    <xs:documentation>
                        Школы.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="car_dealer">
                <xs:annotation>
                    <xs:documentation>
                        Автосалоны.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="photo">
                <xs:annotation>
                    <xs:documentation>
                        Фотоуслуги.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="beauty_center">
                <xs:annotation>
                    <xs:documentation>
                        Салоны красоты.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="dentistry">
                <xs:annotation>
                    <xs:documentation>
                        Стоматология.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="billiards">
                <xs:annotation>
                    <xs:documentation>
                        Бильярдные клубы.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="university">
                <xs:annotation>
                    <xs:documentation>
                        Вузы.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="fitness">
                <xs:annotation>
                    <xs:documentation>
                        Фитнес-клубы.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="pool">
                <xs:annotation>
                    <xs:documentation>
                        Бассейны.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="registry">
                <xs:annotation>
                    <xs:documentation>
                        ЗАГСы.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="museum">
                <xs:annotation>
                    <xs:documentation>
                        Музеи.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="veterinary">
                <xs:annotation>
                    <xs:documentation>
                        Ветеринарные клиники.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="parking">
                <xs:annotation>
                    <xs:documentation>
                        Автостоянки, паркинги.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="driving">
                <xs:annotation>
                    <xs:documentation>
                        Автошколы.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="delivery">
                <xs:annotation>
                    <xs:documentation>
                        Доставка.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="repair_services">
                <xs:annotation>
                    <xs:documentation>
                        Ремонт и обслуживание.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="transport_services">
                <xs:annotation>
                    <xs:documentation>
                        Транспорт, перевозки.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="theatre">
                <xs:annotation>
                    <xs:documentation>
                        Театры.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="gallery">
                <xs:annotation>
                    <xs:documentation>
                        Галереи и выставочные залы.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="solarium">
                <xs:annotation>
                    <xs:documentation>
                        Солярии.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="tattoo">
                <xs:annotation>
                    <xs:documentation>
                        Татуаж, пирсинг.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="cosmetology">
                <xs:annotation>
                    <xs:documentation>
                        Косметологические клиники.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="pet_services">
                <xs:annotation>
                    <xs:documentation>
                        Услуги для животных.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="cleaning_services">
                <xs:annotation>
                    <xs:documentation>
                        Уборка помещений.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="atelier">
                <xs:annotation>
                    <xs:documentation>
                        Ателье.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="safecracker">
                <xs:annotation>
                    <xs:documentation>
                        Аварийные службы по открытию замков.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="training_courses">
                <xs:annotation>
                    <xs:documentation>
                        Система обучения. Повышение квалификации. Трудоустройство.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="financial_services">
                <xs:annotation>
                    <xs:documentation>
                        Финансовые и юридические услуги.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="insurance">
                <xs:annotation>
                    <xs:documentation>
                        Страховые компании.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="mass_media">
                <xs:annotation>
                    <xs:documentation>
                        СМИ, полиграфия, реклама.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="polygraphy">
                <xs:annotation>
                    <xs:documentation>
                        Полиграфические услуги.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="periodicals">
                <xs:annotation>
                    <xs:documentation>
                        Периодические издания.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="tourist_services">
                <xs:annotation>
                    <xs:documentation>
                        Туризм. Отдых. Путешествия.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="realty">
                <xs:annotation>
                    <xs:documentation>
                        Строительство и недвижимость.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="event_services">
                <xs:annotation>
                    <xs:documentation>
                        Все для праздника.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="security">
                <xs:annotation>
                    <xs:documentation>
                        Безопасность.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="authorities">
                <xs:annotation>
                    <xs:documentation>
                        Государственные и административные органы.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="atms">
                <xs:annotation>
                    <xs:documentation>
                        Банкоматы.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="libraries">
                <xs:annotation>
                    <xs:documentation>
                        Библиотеки.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="consumer_services">
                <xs:annotation>
                    <xs:documentation>
                        Бытовые услуги
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="design">
                <xs:annotation>
                    <xs:documentation>
                        Дизайн.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="online_store">
                <xs:annotation>
                    <xs:documentation>
                        Интернет-магазины.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="culture">
                <xs:annotation>
                    <xs:documentation>
                        Культура.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="mobile_operators">
                <xs:annotation>
                    <xs:documentation>
                        Операторы сотовой связи.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="representative_offices">
                <xs:annotation>
                    <xs:documentation>
                        Представительства организаций.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="industrial_companies">
                <xs:annotation>
                    <xs:documentation>
                        Промышленные и производственные предприятия.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="taxi">
                <xs:annotation>
                    <xs:documentation>
                        Такси.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="shopping_malls">
                <xs:annotation>
                    <xs:documentation>
                        Торговые комплексы.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
            <xs:enumeration value="hobbies">
                <xs:annotation>
                    <xs:documentation>
                        Хобби.
                    </xs:documentation>
                </xs:annotation>
            </xs:enumeration>
        </xs:restriction>
    </xs:simpleType>

    <xs:simpleType name="Locale">
        <xs:annotation>
            <xs:documentation>
                Язык, на котором может быть оставлен отзыв.
            </xs:documentation>
        </xs:annotation>
        <xs:restriction base="xs:string">
            <xs:enumeration value="ru"/>
            <xs:enumeration value="en"/>
        </xs:restriction>
    </xs:simpleType>

    <xs:complexType name="Item">
        <xs:annotation>
            <xs:documentation>
                Описание объекта отзыва.
            </xs:documentation>
        </xs:annotation>
        <xs:sequence>
            <xs:element name="vcard" minOccurs="1" maxOccurs="unbounded">
                <xs:complexType>
                    <xs:all>
                        <xs:element name="fn" type="xs:string">
                            <xs:annotation>
                                <xs:documentation>
                                    Название организации.
                                </xs:documentation>
                            </xs:annotation>
                        </xs:element>
                        <xs:element name="category" type="BizCategory">
                            <xs:annotation>
                                <xs:documentation>
Категория, к которой относится объект отзыва. Для отзывов о лечебных учреждениях следует указывать значение hospital.
                                </xs:documentation>
                            </xs:annotation>
                        </xs:element>
                        <xs:element name="altnames" minOccurs="0">
                            <xs:annotation>
                                <xs:documentation>
                                    Другие названия организации.
                                </xs:documentation>
                            </xs:annotation>
                            <xs:complexType>
                                <xs:sequence>
                                    <xs:element name="altname" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
                                </xs:sequence>
                            </xs:complexType>
                        </xs:element>
                        <xs:element name="adrs" minOccurs="0">
                            <xs:annotation>
                                <xs:documentation>
                                    Адреса организации.
                                </xs:documentation>
                            </xs:annotation>
                            <xs:complexType>
                                <xs:sequence>
                                    <xs:element name="adr" minOccurs="1" maxOccurs="unbounded">
                                        <xs:complexType>
                                            <xs:all>
                                                <xs:element name="country-name" type="xs:string" minOccurs="0">
                                                    <xs:annotation>
                                                        <xs:documentation>
                                                            Страна.
                                                        </xs:documentation>
                                                    </xs:annotation>
                                                </xs:element>
                                                <xs:element name="region" type="xs:string" minOccurs="0">
                                                    <xs:annotation>
                                                        <xs:documentation>
Регион + район.
                                                        </xs:documentation>
                                                    </xs:annotation>
                                                </xs:element>
                                                <xs:element name="locality" type="xs:string" minOccurs="0">
                                                    <xs:annotation>
                                                        <xs:documentation>
                                                            Населенный пункт.
                                                        </xs:documentation>
                                                    </xs:annotation>
                                                </xs:element>
                                                <xs:element name="street-address" type="xs:string" minOccurs="0">
                                                    <xs:annotation>
                                                        <xs:documentation>
Адрес с точностью до здания (улица, дом, корпус, строение и т. п.).
                                                        </xs:documentation>
                                                    </xs:annotation>
                                                </xs:element>
                                                <xs:element name="extended-address" type="xs:string" minOccurs="0">
                                                    <xs:annotation>
                                                        <xs:documentation>
Ориентировочное расположение организации (не точный адрес): название торгового или бизнес-центра, местонахождение организации внутри здания (подъезд, этаж, офис).
                                                        </xs:documentation>
                                                    </xs:annotation>
                                                </xs:element>
                                                <xs:element name="postal-code" type="xs:string" minOccurs="0">
                                                    <xs:annotation>
                                                        <xs:documentation>
                                                            Почтовый индекс.
                                                        </xs:documentation>
                                                    </xs:annotation>
                                                </xs:element>
                                            </xs:all>
                                        </xs:complexType>
                                    </xs:element>
                                </xs:sequence>
                            </xs:complexType>
                        </xs:element>
                        <xs:element name="url" type="xs:anyURI" minOccurs="0">
                            <xs:annotation>
                                <xs:documentation>
                                    URL сайта организации.
                                </xs:documentation>
                            </xs:annotation>
                        </xs:element>
                        <xs:element name="localurl" type="xs:anyURI" minOccurs="0">
                            <xs:annotation>
                                <xs:documentation>
                                    URL карточки организации на данном ресурсе.
                                </xs:documentation>
                            </xs:annotation>
                        </xs:element>
                        <xs:element name="email" type="xs:string" minOccurs="0">
                            <xs:annotation>
                                <xs:documentation>
                                    Адрес электронной почты организации.
                                </xs:documentation>
                            </xs:annotation>
                        </xs:element>
                        <xs:element name="geo" minOccurs="0">
                            <xs:annotation>
                                <xs:documentation>
Географические координаты, соответствующие адресу. Указываются в градусах.
                                </xs:documentation>
                            </xs:annotation>
                            <xs:complexType>
                                <xs:all>
                                    <xs:element name="latitude" type="xs:decimal">
                                        <xs:annotation>
                                            <xs:documentation>
                                                Широта.
                                            </xs:documentation>
                                        </xs:annotation>
                                    </xs:element>
                                    <xs:element name="longitude" type="xs:decimal">
                                        <xs:annotation>
                                            <xs:documentation>
                                                Долгота.
                                            </xs:documentation>
                                        </xs:annotation>
                                    </xs:element>
                                </xs:all>
                            </xs:complexType>
                        </xs:element>
                        <xs:element name="tels" minOccurs="0">
                            <xs:annotation>
                                <xs:documentation>
                                    Номера телефонов организации.
                                </xs:documentation>
                            </xs:annotation>
                            <xs:complexType>
                                <xs:sequence>
                                    <xs:element name="tel" type="xs:string" minOccurs="1" maxOccurs="unbounded">
                                        <xs:annotation>
                                            <xs:documentation>
Предпочтительный формат: +«код страны»« код города» «номер». Например: +380 (44) 123-45-67.
                                            </xs:documentation>
                                        </xs:annotation>
                                    </xs:element>
                                </xs:sequence>
                            </xs:complexType>
                        </xs:element>
                        <xs:element name="workhours" type="xs:string" minOccurs="0">
                            <xs:annotation>
                                <xs:documentation>
Время работы организации. Предпочтительный формат: пн-сб 11:00-20:00, вс 12:00-24:00
                                </xs:documentation>
                            </xs:annotation>
                        </xs:element>
                        <xs:element name="photo" type="xs:anyURI" minOccurs="0">
                            <xs:annotation>
                                <xs:documentation>
                                    URL, по которому располагаются фотографии организации.
                                </xs:documentation>
                            </xs:annotation>
                        </xs:element>
                        <xs:element name="logo" type="xs:anyURI" minOccurs="0">
                            <xs:annotation>
                                <xs:documentation>
                                    URL, по которому располагается логотип организации.
                                </xs:documentation>
                            </xs:annotation>
                        </xs:element>
                    </xs:all>
                </xs:complexType>
            </xs:element>
        </xs:sequence>
    </xs:complexType>
</xs:schema>
Пример отзыва, размеченного согласно описанной XSD-схеме
<reviews>    
    <review>
        <locale>ua</locale>
        <type>biz</type>
        <url>
        http://www.restoran.ua/kiev/restoran/mafia/(show)/comments/#comment-50582
        </url>
       <mobile-url>http://m.restoran.ua/kiev/restoran/mafia/(show)/comments/#comment-50582</mobile-url>
        <description>Очень благодарны за прекрасный отдых в вашем ресторане! Очень вкусные блюда, качественное обслуживание и уютная атмосфера! Отдельная благодарность вашему Шеф-повару за очень вкусные мясные блюда! Спасибо!
        </description>
        <reviewer>
            <vcard>
                <fn>Уляна</fn>
            </vcard>
            <avatar>http://s1.foogoo.ua/pic/avatars/80x80/f6700243b8a514eeb6d518ad2a9a075616b3c8a7.jpeg?22378-301b73b8b6d781e966fae81b6688313d</avatar>
                <authpost>103</authpost>
                <authcomments>5066</authcomments>
                <karma>39125</karma>
        </reviewer>
        <item>
            <vcard>
                <category>restaurant</category>
                <fn>Сеть ресторанов «Счастье»</fn>
                <localurl>http://www.restoran.ua/kiev/restoran/schast-e/</localurl>
                <tels>
                    <tel>+380 (44) 123-45-67</tel>
                </tels>
                <adrs>
                    <adr>
                        <country-name>Украина</country-name>
                        <street-address>г. Киев, ул. Маршала Тимошенко, 21, корпус 3</street-address>
                        <extended-address/>
                    </adr>
                </adrs>
            </vcard>
        </item>
        <reviewsurl>
http://www.restoran.ua/kiev/restoran/schast-e/(show)/comments/
        </reviewsurl>
        <dtreviewed>2014-10-05T17:38:12+03:00</dtreviewed>
    </review>
</reviews>

Описание элемента review

Ниже описаны все поддерживаемые поля XSD-схемы для подготовки XML-фида.

Наименование Описание Пример Формат данных
review

Составной элемент. Содержит элементы с описанием отзыва об организации.

Принимает минимальное значение 1, максимальное — unbounded.

BizReview
BizReview Отзыв об организации. Обязательный элемент.
url URL отзыва. Должен быть уникальным и постоянным (см. Технические требования к сайту Партнера). Обязательный элемент.

http://restoran.ua/kiev/restoran/otziv

xs:anyURI
mobile-url

Постоянная ссылка на мобильную версию страницы отзыва.

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

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

http://m.restoran.ua/kiev/restoran/otziv

xs:anyURI
type Тип объекта отзыва. Для отзывов об организациях нужно указать значение biz. Обязательный элемент. biz xs:string
locale

Язык, на котором написан отзыв. Для отзывов на украинском языке следует указывать значение ua.

uk

Locale
summary

Краткая аннотация к отзыву.

Принимает минимальное значение 0.

xs:string
description

Текст отзыва.

Принимает минимальное значение 0.

Очень благодарны за прекрасный отдых в вашем ресторане!

xs:string
pros

Список достоинств объекта отзыва.

Принимает минимальное значение 0.

pro

Описание достоинства.

Принимает минимальное значение 1, максимальное — unbounded.

Неплохие идеи интерьера и развлекательной программы

xs:string
contras

Список недостатков объекта отзыва.

Принимает минимальное значение 0.

contra

Описание недостатков.

Принимает минимальное значение 1, максимальное — unbounded.

Хорошее обслуживание

xs:string
rating

Оценка (рейтинг) автора отзыва в числовом формате с фиксированной точкой (например, 4.0, 4.5 или 4).

По умолчанию рейтинг считается от 1 до 5.

Принимает минимальное значение 0.
3.5 xs:decimal
best-rating

Верхняя граница шкалы рейтинга, если она отличается от 5.

Принимает минимальное значение 0.

5 xs:decimal
worst-rating

Нижняя граница шкалы рейтинга, если она отличается от 1.

Принимает минимальное значение 0.

1 xs:decimal
RatedProperty Оцениваемые параметры организации. Желательный элемент.
tags

Список оценок (рейтинги).

Принимает минимальное значение 0.

Tag

Сложный элемент. Конкретная оценка некоторого параметра организации.

Принимает минимальное значение 1, максимальное — unbounded.

value

Значение оценки параметра организации. Число с фиксированной точкой (например, 4.0, 4.5 или 4).

Принимает минимальное значение 1.

3 xs:decimal
name

Оцениваемый параметр организации.

Принимает минимальное значение 1.

cuisine RatedProperty
best

Максимальное возможное значение оценки.

Принимает минимальное значение 0.
5 xs:decimal
worst

Минимальное возможное значение оценки.

Принимает минимальное значение 0.
1 xs:decimal
useful

Количество голосов «за» отзыв.

Принимает минимальное значение 0.

10 xs:nonNegativeInteger
useless

Количество голосов «против» отзыва.

Принимает минимальное значение 0.

1 xs:integer
likes

Количество «лайков», «благодарностей» за отзыв.

Принимает минимальное значение 0.

30 xs:nonNegativeInteger
comments

Количество комментариев к отзыву.

Принимает минимальное значение 0.

5 xs:nonNegativeInteger
dtreviewed

Дата написания отзыва в формате ISO 8601 (YYYY-MM-DDT).

Обязательный элемент.

2005-08-09T18:31 xs:dateTime
dtvisited

Дата посещения организации в формате ISO 8601 (YYYY-MM-DDT).

Принимает минимальное значение 0.

2012-09-12T xs:date
reviewsurl

URL страницы, на которой собраны другие отзывы этой организации.

Принимает минимальное значение 0.

http://www.restoran.ua/restaurants/comments

xs:anyURI
commenturl

URL страницы, на которой собраны комментарии к этому отзыву.

Принимает минимальное значение 0.

http://www.restoran.ua/restaurants/comment

xs:anyURI
Reviewer Составной элемент. Содержит элементы с данными об авторе отзыва. Обязательный элемент.
vcard

Список данных о профиле пользователя на сайте Партнера.

fn

Имя автора отзыва.

Принимает минимальное значение 0.

Уляна

xs:string
url

URL профиля автора на данном ресурсе.

Принимает минимальное значение 0.

http://www.restoran.ua/users/author

xs:anyURI
email

Адрес электронной почты автора.

Принимает минимальное значение 0.

ulyana@site.ua

xs:string
avatar

URL аватара на данном ресурсе.

Принимает минимальное значение 0.

http://s1.fogo.ua/avatars/image.jpg

xs:anyURI
thanks

Число благодарностей автору от других пользователей.

Принимает минимальное значение 0.

10 xs:nonNegativeInteger
authpost

Число постов (не отзывов) автора на данном ресурсе.

Принимает минимальное значение 0.

103 xs:nonNegativeInteger
authcomments

Число комментариев автора на данном ресурсе.

Принимает минимальное значение 0.

50 xs:nonNegativeInteger
friends

Число «друзей» автора на данном ресурсе.

Принимает минимальное значение 0.

10 xs:nonNegativeInteger
karma

Рейтинг (уровень) доверия к автору.

Принимает минимальное значение 0.

30000 xs:decimal
Item Составной элемент. Содержит элементы, описывающие объект отзыва (организацию).
vcard

Информация об организации на сайте Партнера (карточка организации).

Принимает минимальное значение 0, максимальное — unbounded.

fn Название организации.

Ресторан «Счастье»

xs:string
category Категория, к которой относится объект отзыва. Например, для отзывов о реcторанах следует указывать значение restaurant. restaurant BizCategory
BizCategory

Поддерживаемые категории организаций, на которые может быть оставлен отзыв.

Полный список поддерживаемых категорий представлен в примере XSD-схемы (см. выше).

altnames

Список альтернативных названий организации.

Принимает минимальное значение 0

altname

Конкретное альтернативное название организации. Названий может быть несколько.

Принимает минимальное значение 0, максимальное — unbounded.

Кафе «Счастье»

xs:string
adrs

Список адресов организации.

Принимает минимальное значение 0.

adr

Описание конкретного адреса организации. Адресов может быть несколько.

Принимает минимальное значение 1, максимальное — unbounded.

country-name

Страна.

Принимает минимальное значение 0.

Украина

xs:string
region

Регион и район.

Принимает минимальное значение 0.

xs:string
locality

Населенный пункт.

Принимает минимальное значение 0.

Киев

xs:string
street-address

Адрес с точностью до здания (улица, дом, корпус, строение и т. п.).

Принимает минимальное значение 0.

ул. Маршала Тимошенко, 21, корпус 3

xs:string
extended-address

Ориентировочное расположение организации (не точный адрес): название торгового или бизнес-центра, местонахождение организации внутри здания (подъезд, этаж, офис).

Принимает минимальное значение 0.

Отель «Англетер», 1-й этаж xs:string
postal-code

Почтовый индекс.

Принимает минимальное значение 0.

190000 xs:string
url

URL сайта организации.

Принимает минимальное значение 0.

http://schastye.com xs:anyURI
localurl

URL карточки организации на данном ресурсе.

Принимает минимальное значение 0.

http://www.restoran.ua/kiev/restoran/schast-e

xs:anyURI
email

Адрес электронной почты организации.

Принимает минимальное значение 0.

schaste@globalpointfamily.com

xs:string
geo

Географические координаты, соответствующие адресу.

Указываются в градусах.

latitude Широта. xs:decimal
longitude Долгота. xs:decimal
tels

Список номеров телефонов организации. Принимает минимальное значение 0.

tel

Предпочтительный формат: +код страны (код города) номер.

Принимает минимальное значение 1, максимальное — unbounded.

+380 (44) 123-45-67

xs:string
workhours

Время работы организации. Предпочтительный формат: dd-dd hh:mm−hh:mm, dd hh:mm−hh:mm.

Принимает минимальное значение 0.

пн−сб 11:00−20:00, вс 12:00−24:00 xs:string
photo URL, по которому располагаются фотографии организации.

http://www.restoran.ua/kiev/restoran/photo

xs:anyURI
logo

URL логотипа организации.

Принимает минимальное значение 0.

http://www.restoran.ua/kiev/restoran/logo.png

xs:anyURI
Locale Язык, на котором может быть оставлен отзыв (например, значения ru, ua или en). ua