Вебмайстер
Яндекс для вебмайстрів
Як Яндекс індексує сайти
Сайт на сторінці результатів пошуку
Сервіс «Яндекс.Вебмайстер»
Налаштування індексування
Вміст сайту
Сайт у результатах пошуку
Безпека сайтів
Сервіси Яндекса на вашому сайті

Технічні вимоги до трансляції відгуків про організації за допомогою 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-файлу
    " "
    & &
    > >
    < <
    ''
  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: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
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 Категорія, до якої відноситься об'єкт відгуку. Наприклад, для відгуків про ресторани слід вказувати значення 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
Оцініть статтю
Дякуємо за ваш відгук!