На этой странице представлены описания, значения и требования к атрибутам и дочерним элементам. Эти значения применимы только к объектам недвижимости, сдаваемым в аренду на время отпуска.
Общая структура XML имеет тот же формат, что и фиды с описанием отелей. См. Справочник по XML со списком отелей .
Если не включить следующие обязательные элементы, список автоматически отключается:
- Обязательные дочерние элементы XML:
id
,name
,latitude
,longitude
,address
. - Обязательные атрибуты:
capacity
иwebsite
. См. прямые ссылки на аренду жилья для отпуска в ленте объявлений. Это дает пользователям возможность посетить веб-сайт объекта недвижимости.
Подробную информацию о необходимых дочерних элементах XML см. в разделе Дочерние элементы XML .
Дополнительную информацию о объектах аренды для отпуска см. в разделе «Атрибуты, уникальные для объектов аренды для отпуска» .
Наконец, когда Google определяет из других источников, что значение атрибута отличается от значения, указанного в фиде объявления об аренде жилья для отпуска, Google отображает значение этого объявления. Например, если Google по фотографиям объявления определяет, что в нем есть кухня, но атрибут kitchen
отсутствует или имеет значение No
, Google считает, что в объявлении есть кухня. Эти атрибуты называются «выведенными атрибутами» и отображаются только в том случае, если существует высокая уверенность в точности вывода.
Значения для заполнителя имя_атрибута
В следующей таблице представлен список допустимых значений для 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 |
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 |
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 | Полное физическое расположение объекта недвижимости. Этот элемент принимает единственный атрибут Как минимум, вы должны указать почтовый адрес, город, штат или регион и почтовый индекс объекта недвижимости. Используйте дочерние элементы
Например: <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="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>