Эта страница переведена с помощью Cloud Translation API.

Атрибуты

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

Общая структура XML имеет тот же формат, что и фиды с описанием отелей. См. Справочник по XML со списком отелей .

Если не включить следующие обязательные элементы, список автоматически отключится.

Обязательные дочерние элементы XML: id , name , latitude , longitude , address .
Обязательные атрибуты: capacity и website .
- Обратитесь к прямой ссылке на сайт, указанной в фиде вашего объявления. Это дает пользователям возможность посетить веб-сайт объекта недвижимости.

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

Дополнительную информацию об аренде для отпуска см. в разделе «Атрибуты, уникальные для аренды для отпуска» .

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

Значения для заполнителя имя_атрибута

В следующей таблице представлен список допустимых значений для 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	Максимально возможный рейтинг для объекта недвижимости	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	Точное время суток для заезда в объект размещения. Принимается формат ЧЧММ, ЧЧ:ММ или ЧЧ:ММ:СС; например, используйте 14:00 вместо 14:00 или 14:00. Все остальные форматы не будут анализироваться и отображаться.	Time
check_out_time	Recommended	Точное время суток для выезда из объекта размещения. Принимается формат ЧЧММ, ЧЧ:ММ или ЧЧ:ММ:СС; например, используйте 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
minimum_days_advance_purchase	Recommended	Минимальное количество дней, за которое можно забронировать недвижимость.	Non-negative integer value
minimum_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
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	Тип беспроводного доступа в Интернет, предоставляемый объектом размещения.	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> Это значение можно сгенерировать с помощью инструментов геокодирования, таких как Google Maps API .
<longitude>	Required	float	Долгота, соответствующая местоположению компании. Например: <longitude>-122.090101</longitude> Это значение можно сгенерировать с помощью инструментов геокодирования, таких как Google Maps API .
<name>	Required	string	Название объекта недвижимости. Максимум 300 символов.
<address>	Required	Object or string	Полное физическое расположение объекта недвижимости. Этот элемент принимает единственный атрибут `format` , для которого необходимо установить значение `simple` . Как минимум, вы должны указать почтовый адрес, город, штат или регион и почтовый индекс объекта недвижимости. Используйте дочерние элементы `<component>` для описания каждой из следующих частей адреса: `addr1` : основной адрес объекта недвижимости. `addr2` : Дополнительный адрес, включая номер квартиры, если необходимо. `addr3` : Третья часть адреса. `city` : название города объекта недвижимости. `province` : название штата, региона или провинции объекта. `postal_code` : почтовый индекс объекта недвижимости. Например: <address format="simple"> <component name="addr1">6 Acacia Ave</component> <component name="addr2">Floor 5</component> <component name="city">London</component> <component name="province">Greater London</component> <component name="postal_code">SW1W 9TQ</component> </address> Альтернативно вы можете указать адрес в произвольной форме, хотя это не рекомендуется. Например: <address>6 Elm Ave Unit 3, Boston, MA, 02472</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="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="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="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="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="smoking_free_property">Yes</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>