На этой странице представлены описания, значения и требования к атрибутам и дочерним элементам. Эти значения применимы только к объектам недвижимости, сдаваемым в аренду на время отпуска.
Общая структура XML имеет формат, аналогичный формату лент объявлений о гостиницах. См. справочник по XML-файлам объявлений о гостиницах .
Отсутствие следующих обязательных элементов автоматически приводит к удалению объявления:
- Обязательные дочерние XML-элементы:
id,name,latitude,longitude,address. - Обязательные атрибуты:
capacityиwebsite. Укажите прямые ссылки на объявления о сдаче жилья в аренду на время отпуска в вашем фиде. Это даст пользователям возможность перейти на веб-сайт объекта недвижимости.
Подробную информацию о необходимых дочерних элементах XML см. в разделе «Дочерние элементы XML» .
Для получения более подробной информации о сдаче жилья в аренду на время отпуска, обратитесь к разделу «Особенности, присущие сдаче жилья в аренду на время отпуска» .
Наконец, когда Google на основе других источников определяет, что значение атрибута отличается от указанного в фиде для объявления об аренде жилья для отдыха, Google отображает значение, соответствующее данному объявлению. Например, если Google определяет по фотографиям объявления, что в нем есть кухня, но атрибут kitchen отсутствует или имеет значение No , Google рассматривает объявление как имеющее кухню. Такие атрибуты называются «предполагаемыми атрибутами», и они отображаются только тогда, когда есть высокая степень уверенности в точности предположения.
<review>
Содержит отзыв пользователя или редакционный отзыв. Вам не обязательно включать все отзывы о товаре в элемент <listing> . Этот элемент предназначен для включения избранных отзывов, которые отражают характеристики или качество данного товара.
Элемент <review> располагается в следующем месте в иерархии XML-файлов списка отелей:
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
Синтаксис
Элемент <review> использует следующий синтаксис:
<?xml version="1.0" encodin>g<="UTF-8&>quo<t;?
lis>tings< ...
> listing
cont<ent
..<.
> !-- Specify review's child elements in t>he orde<r shown below. --
> review t<ype=>"edito<rial&>quot;
< >linkreview_l<ink/li>n<k
titlereview_title/title !-- Title is for r>eviews of< type >"editori<al">; only --<
> authorrevi<ew_auth>or/author<
> rating<revie>w_rating/<rati>ng
<bodyr>eview_tex<t/body
> datereview_dat<e/date
> serv<icedate>review_<servicedate/servic>edate
< <>/span>/review
< review type=<">user"
< <>/span>linkreview<_link/link
authorreview_autho>r/<author
date month="MM" day=&>quot;DD&q<uot; year="YYYY"/ !-- Date is for> r<eviews of type "user" only --
servic>edate mon<th=&qu>ot;MM" d<ay=&quo>t;DD"<; ye>ar="YY<YY&qu>ot;/ !<-- Serv>ice D<ate is f>or <reviews >o<f type &q>uot;user" only --
ratingreview_rating/rating
bodyreview_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 | (Только для отзывов пользователей) Дата посещения пользователем объекта, по которому делается отзыв. Формат такой же, как в <дата>. Например, дата 7 июня 2023 года записывается так: <servicedate month="6" day=">7" year="2023"/ Отзывы, в которых не указаны как минимум месяц и год выполнения работ (<servicedate>), могут не отображаться. Указание дня не обязательно. |
Пример
В следующем примере представлен неполный список отелей, содержащий статью и отзыв пользователя:
<?xml version="1.0" encodin>g<="UTF-8"?
listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gs>tat<ic.com/l>oc<alfeed/lo>cal<_feed.x>sd&qu<ot>;
la<ngu>ageen</lan>guage
list<ing
> id<123456/id
nameMy Ap>artment</name
address form>at="simple"<;
co>mponent< name="addr1&quo>t;1 Sandsto<ne Buildin>g/compo<nent
component name=&q>uot;c<ity"L>os Ange<les/component
compo>ne<nt name=&q>uot;p<ostal_co>de&qu<ot;9021>0/<componen>t
< component name<="pr>ovinc<e"CA>/component<
/addr>ess
< country>US/country
<latitu>de40.<730610/l>atitu<de
lo>n<gitude-73.935242/longitude
phone type="main"123>45678</phone
> cat<egoryhotel/category !--> You can <use >whatever property type categories you wis<h --
> conte<nt
> text type="descrip<tion&q>uot;
< >linkhttps://examplelisting.com/listings/12345/link
< title3 bedr<ooms with ocean views/title
>bodySta<y in >this ne<wly renovated 3BR house> with oce<an v>iews./body
date month=<">;7" <day=&>quot;23" year="<;2023&>quot;/
< /text
r<eview t>ype="<;edito>r<ial&quo>t;
< linkhttps://example.com/revi<ews/4>2/link
< > titleA< little piece of h>eaven/tit<le
> authorEXAMPLE.COM/author
< <>/span>rating8/ra<ting
> bodyThis< place >is really< good.>/<body
> /revi<ew
> review type="user"
linkhttps://ex<ample>person.or<g/reviews/82/link
authorSus>an von Tr<app/author
rating6/rating
b>odyNot <a bad p>lace, b<ut I prefe>r to be c<loser t>o the beach./body
< date da>y="6<" month="7">; y<ear="20>23"/<
servicedate day=">;1<6" mont>h="<;6" ye>ar=&quo<t;2023"/
/review
attribut>es
< websitehttps://hote<l.exa>mple.com/<websi>te
client_<attr n>ame=&qu<ot;rat>ing&q<uot;8.2/>cli<ent_attr>
< >client_attr name="num_reviews"14/client_attr
/attributes
image type="photo" url="https://image_url"
linkhttps://image_url/link
titleMain 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 | Полное физическое местоположение объекта недвижимости в виде строки. Адрес должен включать название улицы и номер дома. Если адреса нет, следует добавить аббревиатуру . Номера квартир или апартаментов также должны быть указаны, если применимо. В качестве альтернативы вы можете указать составной адрес. Используйте дочерние элементы
Обратите внимание, что абонентские ящики или другие почтовые адреса не считаются полными физическими адресами. Вот примеры полных адресов: <address>6 Acacia Ave Apt. 2, Nottingham NG8 6FT, UK/address> <address> <component name="a>ddr1"6 <Acacia Ave>/co<mponent component na>me=&qu<ot;addr2&q>uot<;Apt. 2/component c>omponent na<me="c>ity<"Nottingham /component > compo<nent name=>&qu<ot;postal_code"NG8 >6F<T/componen>t< compo>nent name="country"UK/component /address Вот примеры полных адресов с использованием кода «плюс»: <address>XQHM+7VF Nottingham NG8 6FT, UK/address> <address> <component name="a>ddr1&quo<t;XQHM+7VF>/co<mponent component n>ame="c<ity"N>ott<ingham /component componen>t name=<"post>al_<code"NG8 6FT/compon>en<t compon>e<nt name=>"country"UK/component /address Избегайте следующих действий:
|
Пример объявления о сдаче жилья в аренду на время отпуска
<?xml version="1.0" encodin>g<="U>TF-<8"?> l<istings > la<nguagee>n/lan<gu>age <lis>ting < >id123456/id < nam>eApar<tment Name/name add>ress fo<rmat="simple">; compone<nt name=&q>uot;add<r1"18733 Clark Wa>y/co<mponent > com<ponent name="add>r2"#C10/<component > c<omponent name="city&quo>t;Mou<ntain View>/compon<ent component name=>"post<al_code&qu>ot;94<043/comp>onent< >co<mponent >name=<"pr>ovince&quo<t;Califor>nia/c<omponent<>/span> /address< count>ryUS/<country latit>ude37.41<82515/>latit<ude >longitude-122.<0742354/l>ongit<ude phone type="main"12>34567<8/phone> ca<tegoryvacation_villa/ca>tegory < da>te day="21&<quot;> month=&q<uot;1>2" year=&quo<t;2017>"/ < c>ontent tex<t typ>e="<;desc>ription<" linkhttp>s://list_<url/>link titleDescription <Title>/title < > bodyDescription Body/bo<dy > /text < >review <type=&q>uot;edito<rial&q>u<ot; > link<http>s://example.com/reviews/42</link> < title>A littl<e piece of heaven/>title < > authorEXAMPLE/author rating<8/rat>ing < bod>yThis place is <really >good./bod<y > < /revie>w r<evie>w type="user" linkhttps://exampleperso<n.org>/reviews/<82/link authorSusan von Tra>pp/author< rating6/rating bodyNot a b>ad plac<e, but >I prefe<r to be cl>oser to t<he beac>h./body date day="6<" m>onth=&quo<t;7" year="2017&q>u<ot;/ > serviced<ate day="16" month="6&quo>t; <year="2>017"</ /review attributes >w<ebsitehttps:>//hotel.e<xample.com/123456/website client_attr >nam<e="capa>city"<;7/client_attr client_attr name>="cleaning_disinfection&qu<ot;Yes/clien>t_attr < client_attr name="min_days_>b<etween_stays>"3/c<lient_attr client_attr name=&>q<uot;enhanced>_cleaning<_practices"Yes/client_attr > < client>_attr nam<e="partner_hygiene_link"http:/>/ww<w.example.co>m/hygiene<//client_attr cli>ent<_attr name=&>quot;numb<er_of_bathrooms"2/client>_att<r cl>ient_attr< name="number_of_bedrooms&>q<uot;3/client>_attr < client_attr name>=&q<uot;number_o>f_beds&qu<ot;4/client_attr client_at>tr <name="s>elf_check<in_checkout"Yes/clien>t_<attr > client_a<ttr name="rating"4.8/>cli<ent_attr > clie<nt_attr name="rating_num&qu>ot;53<73/client_at>tr < client_attr name="rating_s>cale&<quot;5/clien>t_attr < client_attr name="ac&q>uot<;Yes/client_>attr < client_attr name=&q>uot;air<port_shuttle>"Yes</client_attr client>_at<tr name=&quo>t;balcony<"No/client_attr >client_<attr name=&q>uot;beach<_access"Yes/client_attr > < client_attr> name=&qu<ot;check_in_time"15:00/client_attr > < client_>attr name<="check_out_time">;11<:00/client_a>ttr < client_attr name="child_fri>endly"Yes/client_attr client_attr name=&q<uot;crib&quo>t;Unknown</client_attr client_>attr name="elev<ator"Ye>s/client_<attr client_attr name=&q>uot;fire_p<lace"Un>known/cli<ent_attr client_attr name=&qu>ot;f<ree_breakfas>t"Ye<s/client_attr client_attr nam>e=&quo<t;gym_fitnes>s_equipme<nt"Yes/client_attr > < client_at>tr name=&<quot;heating"Yes/client_attr > < client_a>ttr name=<"host_description"A sh>ort <description >about the< host and their interests/client>_a<ttr >client_at<tr name="host_name&qu>ot;<The name of >the host/<client_attr client_att>r name="host_language"en, da, el/client_attr client_attr name="host_r<esponse_rate>"0.7<5/client_attr client_a>ttr name="h<ost_response>_time&quo<t;1 hour/client_attr > cl<ient_attr na>me="<hot_tub"Yes/client_attr > < client_at>tr name=&<quot;instant_bookable"Yes/client_attr > < client>_attr nam<e="internet_type"Free/c>l<ient_attr > cli<ent_attr name="ironing_board"No>/<client_attr > c<lient_attr name="kitchen&qu>ot<;Yes/client_>attr < client_attr name="li>cen<se_num">Free text<. If multiple licenses exist, w>e su<ggest adding> authorit<y of the licence as cont>ext/cli<ent_attr > clie<nt_attr name="license_num&>quo<t;Paris: 123>456ABC/cl<ient_attr client_att>r name=<"microw>ave"<Yes/client_attr client_attr nam>e="<;max_night_s>tay"<7/client_attr client>_attr name=&<quot;min_day>s_advance<_purchase"2/client_attr > client_attr name="min_ni<ght_stay&quo>t;3/clien<t_attr client_attr name="nu>mbe<r_of_living_>rooms&quo<t;1/client_attr client_attr name>=&<quot;outdoor>_grill&qu<ot;No/client_attr client_>attr< name=">oven_stov<e"Yes/client_att>r < clien>t_attr na<me="parking_type"Free>/cl<ient_attr > cli<ent_attr name="patio"Unknown/c>lie<nt_attr > cli<ent_attr na>me=&q<uot;pets>_al<lowed&qu>o<t;Yes/cli>ent_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