Атрибуты

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

Общая структура XML имеет формат, аналогичный формату лент объявлений о гостиницах. См. справочник по XML-файлам объявлений о гостиницах .

Отсутствие следующих обязательных элементов автоматически приводит к удалению объявления:

Подробную информацию о необходимых дочерних элементах XML см. в разделе «Дочерние элементы XML» .

Для получения более подробной информации о сдаче жилья в аренду на время отпуска, обратитесь к разделу «Особенности, присущие сдаче жилья в аренду на время отпуска» .

Наконец, когда Google на основе других источников определяет, что значение атрибута отличается от указанного в фиде для объявления об аренде жилья для отдыха, Google отображает значение, соответствующее данному объявлению. Например, если Google определяет по фотографиям объявления, что в нем есть кухня, но атрибут kitchen отсутствует или имеет значение No , Google рассматривает объявление как имеющее кухню. Такие атрибуты называются «предполагаемыми атрибутами», и они отображаются только тогда, когда есть высокая степень уверенности в точности предположения.

<review>

Содержит отзыв пользователя или редакционный отзыв. Вам не обязательно включать все отзывы о товаре в элемент <listing> . Этот элемент предназначен для включения избранных отзывов, которые отражают характеристики или качество данного товара.

Элемент <review> располагается в следующем месте в иерархии XML-файлов списка отелей:

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <review>

Синтаксис

Элемент <review> использует следующий синтаксис:

<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
  <listing>
    <content>
      ...
      <!-- Specify <review>'s child elements in the order shown below. -->
      <review type="editorial">
        <link>review_link</link>
        <title>review_title</title> <!-- Title is for reviews of type "editorial" only -->
        <author>review_author</author>
        <rating>review_rating</rating>
        <body>review_text</body>
        <date>review_date</date>
        <servicedate>review_servicedate</servicedate>
      </review>
      <review type="user">
        <link>review_link</link>
        <author>review_author</author>
        <date month="MM" day="DD" year="YYYY"/>  <!-- Date is for reviews of type "user" only -->
        <servicedate month="MM" day="DD" year="YYYY"/>  <!-- Service Date is for reviews of type "user" only -->
        <rating>review_rating</rating>
        <body>review_text</body>
      </review>
    </content>
  </listing>
</listings>

Атрибуты

Элемент <review> имеет следующие атрибуты:

Атрибут Необходимый? Описание
type Required Тип отзыва. Установите одно из следующих значений:
  • editorial : Рецензия, подготовленная веб-сайтом или другим экспертным органом.
  • user : Отзыв от конечного пользователя.

Дочерние элементы

Элемент <review> имеет следующие дочерние элементы:

Дочерний элемент Необходимый? Тип Описание
<link> Optional string Ссылка на отзыв. Включите в этот элемент "http://" или "https://".
<title> Optional string (Только для редакционных рецензий) Заголовок рецензии.
<author> Optional string Автор рецензии, например, «Сьюзен фон Трапп». Это также может быть название веб-сайта или издания, в котором опубликована рецензия, если автор не указан.
<rating> Optional string Число с плавающей запятой от 0 до 10 (включительно), представляющее оценку отзыва. Например, "8,9".
<body> Optional string Текст отзыва. Этот элемент не должен содержать HTML-код.
<date month=" MM " day=" DD " year=" YYYY "/> Optional Object (Только для отзывов пользователей) Дата отзыва, которую вы указываете с помощью следующих атрибутов этого элемента:
  • day : День месяца; например, «7».
  • month : месяц, где 1 = январь ... 12 = декабрь.
  • year : Четырехзначный год; например, "2023".

Например, дата 7 июня 2023 года записывается так:

<date month="6" day="7" year="2023"/>
<servicedate month=" MM " day=" DD " year=" YYYY "/> Optional Object (Только для отзывов пользователей) Дата посещения пользователем объекта, по которому делается отзыв. Формат такой же, как в <дата>.

Например, дата 7 июня 2023 года записывается так:

<servicedate month="6" day="7" year="2023"/>

Отзывы, в которых не указаны как минимум месяц и год выполнения работ (<servicedate>), могут не отображаться. Указание дня не обязательно.

Пример

В следующем примере представлен неполный список отелей, содержащий статью и отзыв пользователя:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>My Apartment</name>
    <address format="simple">
      <component name="addr1">1 Sandstone Building</component>
      <component name="city">Los Angeles</component>
      <component name="postal_code">90210</component>
      <component name="province">CA</component>
    </address>
    <country>US</country>
    <latitude>40.730610</latitude>
    <longitude>-73.935242</longitude>
    <phone type="main">12345678</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
    <content>
      <text type="description">
        <link>https://examplelisting.com/listings/12345</link>
        <title>3 bedrooms with ocean views</title>
        <body>Stay in this newly renovated 3BR house with ocean views.</body>
        <date month="7" day="23" year="2023"/>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE.COM</author>
        <rating>8</rating>
        <body>This place is really good.</body>
      </review>
      <review type="user">
        <link>https://exampleperson.org/reviews/82</link>
        <author>Susan von Trapp</author>
        <rating>6</rating>
        <body>Not a bad place, but I prefer to be closer to the beach.</body>
        <date day="6" month="7" year="2023"/>
        <servicedate day="16" month="6" year="2023"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="num_reviews">14</client_attr>
      </attributes>
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main hotel picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

Значения для заполнителя attribute_name

В приведенной ниже таблице представлен список допустимых значений для attribute_name в элементе <client_attr name="attribute_name"> ; однако рекомендуется указать свой дополнительный attribute_name если он доступен.

Значения для attribute_name Необходимый? Описание Допустимые значения содержимого
capacity Required Максимальное количество гостей, которое может вместить объект размещения. Это значение должно быть равно или больше значения "number_of_bedrooms". Non-negative integer value
website Required URL-адрес веб-сайта объекта недвижимости. Он должен быть уникальным для данного объявления и не должен дублироваться в нескольких объявлениях. Free text
partner_hygiene_link Strongly recommended Ссылка на сайт внешнего партнера, содержащий более подробную информацию о санитарных условиях объекта размещения. Free text (the site's URL)
number_of_bathrooms Strongly recommended Количество ванных комнат. Non-negative float value, for example, 1, 1.5, 2
number_of_bedrooms Strongly recommended Количество спален. Non-negative integer value
number_of_beds Strongly recommended Количество спальных мест во всех комнатах. Non-negative integer value
self_checkin_checkout Recommended Предусмотрена ли самостоятельная регистрация заезда и выезда в данном объекте размещения. Yes/No/Unknown
rating Strongly recommended Число с плавающей запятой, представляющее собой совокупный рейтинг объекта недвижимости. Обычно это число от 0 до 5, от 0 до 10 или от 0 до 100, но вы можете использовать любой диапазон, соответствующий вашей системе рейтингов. Non-negative float value
rating_num Strongly recommended Количество оценок, которые получил объект недвижимости. Non-negative integer value
rating_scale Strongly recommended Максимально возможный рейтинг для объекта недвижимости. Например, рейтинг объекта должен быть 3 или 4, что соответствует 5-балльной шкале рейтинга.

Примечание: Если параметр rating_scale не указан, он по умолчанию равен 0-10.

 Non-negative integer value
instant_bookable Strongly recommended Можно ли забронировать объект недвижимости мгновенно через процесс выезда? Альтернативный вариант — дождаться подтверждения бронирования. Yes/No/Unknown
description Strongly recommended Текст в свободной форме, описывающий уникальные особенности объекта недвижимости. Free text
category Strongly recommended Тип недвижимости, например, вилла, бунгало, коттедж или квартира. Free text
ac Recommended Есть ли в объекте недвижимости кондиционер. Yes/No/Unknown
beach_access Recommended Есть ли у объекта недвижимости доступ к общественному пляжу поблизости? Yes/No/Unknown
check_in_time Recommended Точное время заселения в объект размещения. Допускается формат HHMM, HH:MM или HH:MM:SS; например, используйте 14:00 вместо 2pm или 2:00pm. Все остальные форматы не будут обрабатываться или отображаться. Time
check_out_time Recommended Точное время выезда из объекта размещения. Допускается формат HHMM, HH:MM или HH:MM:SS; например, используйте 11:00 вместо 11:00 или 11:00. Все остальные форматы не будут обрабатываться или отображаться. Time
child_friendly Recommended Подходит ли данное жилье для детей? Yes/No/Unknown
crib Recommended Предоставляется ли в объекте размещения детская кроватка. Yes/No/Unknown
elevator Recommended Наличие лифта в здании. Yes/No/Unknown
gym_fitness_equipment Recommended Наличие в объекте недвижимости тренажерного зала или какого-либо фитнес-оборудования. Yes/No/Unknown
heating Recommended Есть ли в доме отопление? Yes/No/Unknown
hot_tub Recommended Есть ли в доме джакузи? Yes/No/Unknown
ironing_board Recommended Есть ли в отеле гладильные доски? Yes/No/Unknown
kitchen Recommended Есть ли в доме кухня. Yes/No/Unknown
microwave Recommended Есть ли в объекте размещения микроволновая печь? Yes/No/Unknown
min_days_advance_purchase Recommended Минимальное количество дней, за которое можно забронировать объект размещения. Non-negative integer value
min_night_stay Recommended Минимальное количество ночей, на которое гость может забронировать объект размещения. Positive integer (more than zero)
max_night_stay Recommended Максимальное количество ночей, на которое гость может забронировать объект размещения. Positive integer (more than zero)
outdoor_grill Recommended Есть ли на территории гриль? Yes/No/Unknown
oven_stove Recommended Наличие в доме плиты и/или духовки. Yes/No/Unknown
parking_type Recommended Типы парковочных мест, доступных на территории объекта. Free/Paid/None
patio Recommended Есть ли в доме патио? Yes/No/Unknown
pets_allowed Recommended В некоторых или во всех номерах гостям разрешено привозить с собой домашних животных — собак или кошек, не являющихся животными-помощниками. Yes/No/Unknown
pool_type Recommended Тип бассейна (доступ к бассейну), которым располагает объект недвижимости. Indoors, Outdoors, Indoors/Outdoors, None
room_type Recommended Тип помещения. Поддерживается только значение ENTIRE_PLACE . ENTIRE_PLACE
smoking_free_property Recommended Является ли данное помещение зоной, свободной от курения, или же курение в нем запрещено. Yes/No/Unknown
special_service_level Recommended Отличается ли уровень обслуживания объявления каким-либо образом? Например, verified , luxury , premium Yes/No/Unknown
square_footage Recommended Площадь объекта недвижимости указана в квадратных футах. Non-negative float value
square_meters Recommended Площадь объекта недвижимости указана в квадратных метрах. Non-negative float
tv Recommended Есть ли в доме телевизор? Yes/No/Unknown
washer_dryer Recommended Есть ли в доме стиральная машина и сушилка? Yes/No/Unknown
wheelchair_accessible Recommended Доступно ли данное жилье для людей в инвалидных колясках? Yes/No/Unknown
internet_type Recommended Тип Wi-Fi доступа в интернет, предоставляемый объектом размещения. Free/Paid/None
airport_shuttle Optional Предоставляет ли принимающая сторона транспорт до аэропорта или других терминалов и обратно. Yes/No/Unknown
balcony Optional Наличие балкона в квартире. Yes/No/Unknown
fire_place Optional Есть ли в доме камин. Yes/No/Unknown
free_breakfast Optional Включен ли в стоимость проживания бесплатный завтрак. Yes/No/Unknown
host_description Optional Описание владельца объекта недвижимости, сдающегося в аренду на время отпуска. Free text
host_language Optional Языки, на которых говорит хозяин. Список языковых кодов , разделённых запятыми; например: de , en
host_name Optional Имя владельца объекта недвижимости, сдающегося в аренду на время отпуска. Free text
host_response_rate Optional Средняя скорость ответа хоста. Non-negative float value, for example, 1, 0.75, 0.5
host_response_time Optional Среднее время отклика хоста. Free text
license_num Optional Номер лицензии (туристической или коммерческой), который необходимо указывать для объектов недвижимости в определенных регионах мира. Он может повторяться, и, если существует несколько лицензий, мы рекомендуем добавить в качестве контекста наименование органа, выдавшего лицензию; например: "Париж: 123456ABC". Free text
number_of_half_bathrooms Optional Количество туалетов (половина ванной комнаты, половина ванной). Non-negative integer value
number_of_living_rooms Optional Количество гостиных. Non-negative integer value
private_beach_access Optional Есть ли у объекта недвижимости выделенный доступ к закрытому для посещения пляжу. Yes/No/Unknown
refund_policy Optional Правила возврата средств за предоставленное жилье. Free text

XML дочерние элементы

Необходимы следующие дочерние XML-элементы:

Дочерний элемент Необходимый? Тип Описание
<country> Strongly recommended string Страна, в которой находится данное объявление. Значение должно представлять собой двухбуквенный код страны по стандарту ISO 3116 ; например, Соединенные Штаты — это US , а Канада — CA 
    <country>US</country>
<id> Required string Уникальный идентификатор объекта недвижимости. Обратите внимание, что каждый объект аренды для отдыха должен иметь уникальный идентификатор, присвоенный вашему сайту, и этот идентификатор ни в коем случае нельзя использовать повторно.
<latitude> Required float Широта, соответствующая местоположению объявления. Например:
    <latitude>37.423738</latitude>

Это значение можно получить с помощью инструментов геокодирования, таких как API Google Maps .

<longitude> Required float Долгота, соответствующая местоположению объявления. Например:
    <longitude>-122.090101</longitude>

Это значение можно получить с помощью инструментов геокодирования, таких как API Google Maps .

<name> Required string Название объекта недвижимости. Не более 300 символов.
<address> Required string or Object

Полное физическое местоположение объекта недвижимости в виде строки. Адрес должен включать название улицы и номер дома. Если адреса нет, следует добавить аббревиатуру . Номера квартир или апартаментов также должны быть указаны, если применимо.

В качестве альтернативы вы можете указать составной адрес. Используйте дочерние элементы <component> для описания каждой из следующих частей адреса:

  • addr1 : Основной адрес улицы.
  • addr2 : При необходимости, дополнительный адрес улицы, включая номер квартиры.
  • city : Город.
  • province : При необходимости — штат, регион или провинция.
  • postal_code : Почтовый индекс.
  • country : Страна.

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

Вот примеры полных адресов:

<address>6 Acacia Ave Apt. 2, Nottingham NG8 6FT, UK/address>
<address>
  <component name="addr1">6 Acacia Ave</component>
  <component name="addr2">Apt. 2</component>
  <component name="city">Nottingham </component>
  <component name="postal_code">NG8 6FT</component>
  <component name="country">UK</component>
</address>

Вот примеры полных адресов с использованием кода «плюс»: 

<address>XQHM+7VF Nottingham NG8 6FT, UK/address>
<address>
  <component name="addr1">XQHM+7VF</component>
  <component name="city">Nottingham </component>
  <component name="postal_code">NG8 6FT</component>
  <component name="country">UK</component>
</address>

Избегайте следующих действий:

  • Избыточная информация: Не включайте лишнюю информацию или повторяющиеся элементы адреса.
  • Отсутствие адреса улицы: Адрес должен содержать название улицы и номер дома.

Пример объявления о сдаче жилья в аренду на время отпуска 

<?xml version="1.0" encoding="UTF-8"?>
<listings>
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>Apartment Name</name>
    <address format="simple">
      <component name="addr1">18733 Clark Way</component>
      <component name="addr2">#C10</component>
      <component name="city">Mountain View</component>
      <component name="postal_code">94043</component>
      <component name="province">California</component>
    </address>
    <country>US</country>
    <latitude>37.4182515</latitude>
    <longitude>-122.0742354</longitude>
    <phone type="main">12345678</phone>
    <category>vacation_villa</category>
    <date day="21" month="12" year="2017"/>
    <content>
      <text type="description">
        <link>https://list_url</link>
        <title>Description Title</title>
        <body>Description Body</body>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE</author>
        <rating>8</rating>
        <body>This place is really good.</body>
      </review>
      <review type="user">
        <link>https://exampleperson.org/reviews/82</link>
        <author>Susan von Trapp</author>
        <rating>6</rating>
        <body>Not a bad place, but I prefer to be closer to the beach.</body>
        <date day="6" month="7" year="2017"/>
        <servicedate day="16" month="6" year="2017"/>
      </review>
      <attributes>
        <website>https://hotel.example.com/123456</website>
        <client_attr name="capacity">7</client_attr>
        <client_attr name="cleaning_disinfection">Yes</client_attr>
        <client_attr name="min_days_between_stays">3</client_attr>
        <client_attr name="enhanced_cleaning_practices">Yes</client_attr>
        <client_attr name="partner_hygiene_link">http://www.example.com/hygiene/</client_attr>
        <client_attr name="number_of_bathrooms">2</client_attr>
        <client_attr name="number_of_bedrooms">3</client_attr>
        <client_attr name="number_of_beds">4</client_attr>
        <client_attr name="self_checkin_checkout">Yes</client_attr>
        <client_attr name="rating">4.8</client_attr>
        <client_attr name="rating_num">5373</client_attr>
        <client_attr name="rating_scale">5</client_attr>
        <client_attr name="ac">Yes</client_attr>
        <client_attr name="airport_shuttle">Yes</client_attr>
        <client_attr name="balcony">No</client_attr>
        <client_attr name="beach_access">Yes</client_attr>
        <client_attr name="check_in_time">15:00</client_attr>
        <client_attr name="check_out_time">11:00</client_attr>
        <client_attr name="child_friendly">Yes</client_attr>
        <client_attr name="crib">Unknown</client_attr>
        <client_attr name="elevator">Yes</client_attr>
        <client_attr name="fire_place">Unknown</client_attr>
        <client_attr name="free_breakfast">Yes</client_attr>
        <client_attr name="gym_fitness_equipment">Yes</client_attr>
        <client_attr name="heating">Yes</client_attr>
        <client_attr name="host_description">A short description about the host and their interests</client_attr>
        <client_attr name="host_name">The name of the host</client_attr>
        <client_attr name="host_language">en, da, el</client_attr>
        <client_attr name="host_response_rate">0.75</client_attr>
        <client_attr name="host_response_time">1 hour</client_attr>
        <client_attr name="hot_tub">Yes</client_attr>
        <client_attr name="instant_bookable">Yes</client_attr>
        <client_attr name="internet_type">Free</client_attr>
        <client_attr name="ironing_board">No</client_attr>
        <client_attr name="kitchen">Yes</client_attr>
        <client_attr name="license_num">Free text. If multiple licenses exist, we suggest adding authority of the licence as context</client_attr>
        <client_attr name="license_num">Paris: 123456ABC</client_attr>
        <client_attr name="microwave">Yes</client_attr>
        <client_attr name="max_night_stay">7</client_attr>
        <client_attr name="min_days_advance_purchase">2</client_attr>
        <client_attr name="min_night_stay">3</client_attr>
        <client_attr name="number_of_living_rooms">1</client_attr>
        <client_attr name="outdoor_grill">No</client_attr>
        <client_attr name="oven_stove">Yes</client_attr>
        <client_attr name="parking_type">Free</client_attr>
        <client_attr name="patio">Unknown</client_attr>
        <client_attr name="pets_allowed">Yes</client_attr>
        <client_attr name="pool_type">Indoors</client_attr>
        <client_attr name="private_beach_access">Unknown</client_attr>
        <client_attr name="room_type">ENTIRE_PLACE</client_attr>
        <client_attr name="refund_policy">The refund policy for the property</client_attr>
        <client_attr name="smoking_free_property">Yes</client_attr>
        <client_attr name="special_service_level">No</client_attr>
        <client_attr name="square_footage">1200</client_attr>
        <client_attr name="tv">Yes</client_attr>
        <client_attr name="washer_dryer">Yes</client_attr>
        <client_attr name="wheelchair_accessible">Yes</client_attr>
      </attributes>
    </content>
  </listing>
</listings>