На этой странице приведены описания, значения и требования для атрибутов и дочерних элементов. Эти значения применимы только к жилью для отпуска.
Общая структура XML-файла похожа на формат фидов со списком отелей. Подробнее о руководстве по созданию фида со списком отелей в формате XML…
Если вы не укажете следующие обязательные элементы, страница приложения будет автоматически отключена:
- Обязательные дочерние XML-элементы:
id,name,latitude,longitude,address. - Обязательные атрибуты:
capacityиwebsite. Ознакомьтесь с информацией о прямых ссылках на жилье для отпуска в фиде данных. Это дает пользователям возможность посетить сайт объекта.
Подробнее о дочерних элементах XML…
Подробнее об атрибутах, уникальных для жилья для отпуска…
Наконец, если 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 | Тип отзыва. Укажите одно из следующих значений:
|
Дочерние элементы
Элемент <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 | (Только для отзывов пользователей.) Дата отзыва, которая указывается с помощью следующих атрибутов этого элемента:
Например, 7 июня 2023 года записывается так: <date month="6" day="7" year="2023"/> |
| <servicedate month="MM" day="DD" year="YYYY"/> | Optional | Object | Дата посещения пользователем страницы, о которой он оставил отзыв. Формат такой же, как и у тега <date>.
Например, 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 | Максимальная оценка, которую может получить объект. Например, если rating_scale равно 5, то rating должно быть равно 3 или 4.
Примечание. Если шкала не указана, по умолчанию используется 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 | Точное время заезда. Допустимые форматы: ЧЧММ, ЧЧ:ММ или ЧЧ:ММ:СС. Например, вместо 2pm или 2:00pm следует использовать 14:00. Все остальные форматы не будут обработаны или показаны. | Time |
| check_out_time | Recommended | Точное время выезда из объекта размещения. Допустимые форматы: ЧЧММ, ЧЧ:ММ или ЧЧ:ММ:СС. Например, вместо 11:00 или 11:00am следует использовать 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 | Номер лицензии (туристической или бизнес-лицензии) для показа объекта в определенных регионах мира. Это значение может использоваться повторно, а при наличии нескольких лицензий мы рекомендуем добавить информацию об области действия лицензии (например: "Paris: 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 | string or Object | Полный адрес объекта в виде строки. Адрес должен содержать название улицы и номер дома. Если его нет, адрес должен включать плюс-код. Если необходимо, укажите номер квартиры или офиса. Вы также можете указать составной адрес. Используйте дочерние элементы
Учтите, что номер абонентского ящика или только почтовый адрес не считаются полными физическими адресами. Примеры полного адреса: <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> Вот примеры полных адресов с кодами Plus Code: <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>