XML-справка по списку отелей

Список отелей – это один или несколько XML-файлов, в которых перечислены все отели, для которых вы предоставляете информацию о ценах. Сам файл списка отелей не содержит информации о ценах.

Корневым элементом списка отелей является элемент <listings> , который содержит элементы <listing> , описывающие ваши объекты.

Вы создаете список отелей в рамках первоначальной реализации , а затем добавляете или удаляете из него отели в рамках регулярного обслуживания.

Убедитесь, что ваши файлы соответствуют правилам синтаксиса . Например, используйте кодировку UTF-8 и укажите эту схему кодировки, включив атрибут encoding в тег XML.

После создания списка отелей вы можете вручную загрузить его в Google с помощью Hotel Center или разместить на своем сервере .

Найдите и устраните проблемы с данными

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

• Как настроить инвентарь отеля
• Решение проблем с сопоставлением свойств

Требования к листингу

Чтобы иметь право на рекламу отелей в Google, объект в вашем списке отелей должен иметь следующие характеристики:

• Номера, в которых могут проживать платящие гости
• Физическое присутствие и фиксированное место, открытое для публики.
• Неподвижные стены и сантехника
• Минимальный срок пребывания не более 7 дней.

Распространенными примерами неподходящей недвижимости являются круизы и апартаменты, поскольку они обычно не соответствуют критериям Listing requirements .

К участию допускаются кемпинговые домики и другие кемпинговые объекты с фиксированными стенами, водопроводом и климат-контролем (включая дровяные печи или пропановые обогреватели). К помещениям на открытом воздухе, которые не соответствуют критериям, относятся:

• Кемпинги, где гости размещаются в палатках
• Стоянки для автодомов, куда гости привозят свои автофургоны.

<listings>

<listings> является корневым элементом списка отелей и содержит элемент <language> и как минимум один <listing> .

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

+ <listings>
    + <language>
    + <datum>
    + <listing>

Синтаксис

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

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="xsi"
    xsi:noNamespaceSchemaLocation="schema_xsd">
  <language> language_code</language>
  <datum> datum_code </datum>
  <listing> listing</listing>
  ...
</listings>

Атрибуты

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

Атрибут	Необходимый?	Описание
xmlns:xsi	Необходимый	Установите значение http://www.w3.org/2001/XMLSchema-instance .
xsi:noNamespaceSchemaLocation	Необходимый	Установите http://www.gstatic.com/localfeed/local_feed.xsd .

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

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

Дочерний элемент	Необходимый?	Тип	Описание
<language>	Required	string	Язык, на котором написан ваш канал. Установите в качестве значения этого элемента двухбуквенный код языка . Например, en для английского языка.
<datum>	Optional	enum	Этот элемент определяет геодезическую датум или опорную модель для координат широты и долготы, представленных в фиде. Если значение датума не указано, значением по умолчанию для этого элемента является WGS84 , которое используется большинством современных устройств GPS. Датат Токио применим только к адресам в Японии. Допустимые значения для этого элемента: WGS84 wgs84 TOKYO tokyo Примечание. Чтобы использовать значение по умолчанию WGS84 , не включайте элемент <datum> в список отелей.
<listing>	Required	<listing>	Одна или несколько записей, описывающих каждый отель в ленте. Обратите внимание, что каждый отель в списке должен иметь уникальный идентификатор вашего сайта, и этот идентификатор никогда не следует использовать повторно.

Примеры

Структурированный адрес

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

<?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>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <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>
    <country>GB</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
  </listing>
  ...
</listings>

Адрес в свободной форме

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

<?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>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <address>6 Elm Ave Unit 3, Boston, MA, 02472</address>
    <country>US</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
  </listing>
  ...
</listings>

Дополнительный контент

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

<?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>

<listing>

Определение отеля в элементе списка отелей <listings> .

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

+ <listings>
    + <language>
    + <listing>

Синтаксис

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

<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
  <listing>
    <!-- Specify <listing>'s child elements in the order shown below. -->
    <id>hotel_ID</id>
    <name>hotel_name</name>
    <address>
      <component name="addr1">street_address_1</component>
      <component name="addr2">street_address_2</component>
      <component name="city">city_name</component>
      <component name="province">province_name</component>
      <component name="postal_code">postal_code</component>
    </address>
    <!-- You can also define an address freeform, although this is not recommended: -->
    <!-- <address>freeform_address</address> -->

    <country>country_code</country>
    <latitude>hotel_latitude</latitude>
    <longitude>hotel_longitude</longitude>
    <phone type="[fax|main|mobile|tdd|tollfree]">phone_number</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
    <content>content</content>
  </listing>
</listings>

Атрибуты

Элемент <listing> не имеет атрибутов.

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

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

Ключевой момент: укажите дочерние элементы в порядке, показанном ниже.

Дочерний элемент	Необходимый?	Тип	Описание
<id>	Required	string	Уникальный идентификатор отеля. Примечание. Это значение должно быть уникальным для вашего сайта всегда. Не используйте идентификаторы повторно, так как это может вызвать проблемы при попытке решить проблемы с сопоставлением свойств .
<name>	Required	string	Название отеля. Например: <name>Belgrave House</name>
<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> Обратите внимание, что абонентские ящики или другие адреса, предназначенные только для почты, не считаются полными физическими адресами.
<country>	Required	string	Страна, в которой находится это объявление. Значение должно представлять собой двухбуквенный код страны . Например, США — это «US», а Канада — «CA». Например: <country>US</country>
<latitude>	Required*	float	Широта, соответствующая местоположению объявления. Например: <latitude>37.423738</latitude> Это значение можно сгенерировать с помощью инструментов геокодирования, таких как Google Maps API .
<longitude>	Required*	float	Долгота, соответствующая местоположению компании. Например: <longitude>-122.090101</longitude> Это значение можно сгенерировать с помощью инструментов геокодирования, таких как Google Maps API .
<location_precision>	Optional	integer	Точность местоположения объекта передается в метрах, если широта и долгота объекта скрыты. Ноль (0) означает, что путаницы нет и это точное местоположение. Примечание. Этот элемент применим только к аренде на время отпуска.
<phone>	Required*	string	Один или несколько контактных номеров отеля. Если в списке указано отделение компании, укажите номер телефона, соответствующий местонахождению филиала (а не номер телефона центрального офиса). Атрибут type может быть одним из следующих: fax : Телефонный номер факса. main : Основной голосовой телефонный номер. mobile : номер мобильного телефона. tdd : телефонный номер телекоммуникационного устройства для глухих (TDD). tollfree : бесплатный телефонный номер. Например: <!-- Singapore (country code +65) --> <phone type="main">[phone]</phone> <!-- U.S. (country code +1) --> <phone type="fax">[phone]</phone> Как минимум, вы должны указать main тип.
<category>	Optional	string	Тип объекта, например отель. Партнеры могут использовать любые внутренние категории для описания своего объекта недвижимости, например «бизнес-отели», «курорты», «мотели» и т.п.
<content>	Optional	<content>	Дополнительные сведения, используемые для объявления, такие как описание, рейтинги и характеристики объекта недвижимости.

* Требуется либо номер телефона , либо широта/долгота. Мы рекомендуем вам определить оба.

Примеры

Структурированный адрес

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

<?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>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <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>
    <country>GB</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
  </listing>
  ...
</listings>

Адрес в свободной форме

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

<?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>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <address>6 Elm Ave Unit 3, Boston, MA, 02472</address>
    <country>US</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
  </listing>
  ...
</listings>

Дополнительный контент

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

<?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>

<content>

Добавляет информацию о объявлении, такую ​​как рейтинги и отзывы, удобства и другие сведения. Элемент <content> является необязательным. Внутри <content> все дочерние элементы являются необязательными.

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

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

Синтаксис

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

<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
  <listing>
    <content>
      <!-- Specify <text>'s child elements in the order shown below. -->
      <text type="description">
        <link>listing_link</link>
        <title>listing_title</title>
        <author>listing_author</author>
        <body>listing_description</body>
        <date month="MM" day="DD" year="YYYY"/>
      </text>
      <!-- 0 or more reviews: -->
      <review type="[editorial|user]">
        ...
      </review>
      <!-- 0 or more attributes: -->
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="alternate_hotel_id">alternate_hotel_id</client_attr>
        <client_attr name="custom_0">custom_attribute_0</client_attr>
        <client_attr name="custom_1">custom_attribute_1</client_attr>
        <client_attr name="custom_2">custom_attribute_2</client_attr>
        <client_attr name="custom_3">custom_attribute_3</client_attr>
        <client_attr name="custom_4">custom_attribute_4</client_attr>
        <client_attr name="hotel_brand">hotel_brand</client_attr>
        <client_attr name="num_reviews">number_of_reviews</client_attr>
        <client_attr name="rating">aggregate_rating</client_attr>
      </attributes>
      <!-- a picture of the hotel or property-->
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main Hotel Picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

Атрибуты

Элемент <content> не имеет атрибутов.

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

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

Дочерний элемент	Необходимый?	Тип	Описание
<text type= "description">	Optional	Object	Веб-страница, связанная с объявлением поставщика. Имеет следующие дочерние элементы: <link> : ссылка на описание. Добавьте «http://» или «https://» в этом элементе (необязательно). <title> : заголовок описания (необязательно). <author> : автор описания (необязательно). <body> : Тело описания ( обязательно ). <date> : дата описания (необязательно). Примечание . Эти элементы должны располагаться в указанном выше порядке.
<review type= "[editorial| user]">	Optional	<review>	Содержит пользовательский или редакционный обзор листинга. В вашем объявлении может быть любое количество отзывов любого типа. Вам не обязательно включать все отзывы об объекте недвижимости в элемент <listing> ; Этот элемент предназначен для включения избранных обзоров, иллюстрирующих особенности или качество этого объявления.
<attributes>	Optional	Object	Содержит 0 или более дочерних элементов <client_attr> , предоставляющих сведения о свойстве. Дочерние элементы используют следующий синтаксис: <client_attr name="attribute_name">attribute_value<client_attr> Список и описание дочерних элементов см. в разделе <attributes> . Все элементы <client_attr> являются необязательными. Если существует дочерний элемент <website> , он должен быть расположен перед любым элементом <client_attr> .
<image>	Optional	Object	Повторяющийся тег, содержит подробную информацию об изображении.

Пример

В следующем примере показан неполный список отелей, включающий элемент <content> :

<?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>

<review>

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

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

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

Ключевой момент: прежде чем сторонние обзоры можно будет интегрировать в Google, вам необходимо заключить лицензионное соглашение на контент (CLA). Ознакомьтесь с разделом «Как отправлять сторонние отзывы в Google» и обратитесь к своему менеджеру по продажам за дополнительной информацией.

Синтаксис

Элемент <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>, могут не отображаться. День не обязателен.

Обратите внимание, что <title> является допустимым дочерним элементом <review> только в том случае, если type обзора — editorial , а <date> допустим только в том случае, если type — user .

Пример

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

<?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>

<attributes>

Тег <attributes> можно использовать для описания удобств объекта, а также для классификации оценок и отзывов об объекте.

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

Ключевой момент: все атрибуты являются необязательными.

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

Дочерний элемент	Необходимый?	Описание
<website>	Optional	Основной сайт отеля. Если он присутствует, он должен быть расположен перед первым элементом <client_attr> . Пример: <website>https://hotel.example.com</website>
<client_attr name=" attribute_name ">	Optional	Дополнительная характеристика или «атрибут» объекта недвижимости, который можно указать с помощью поддерживаемого attribute_name или attribute_name для аренды для отпуска .

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

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

Значения для attribute_name	Описание	Допустимые значения контента
alternate_hotel_id	Альтернативный идентификатор вашего объекта. Наличие отдельных идентификаторов полезно, если вам может понадобиться один идентификатор объекта для информации вашего фида и другой идентификатор объекта для вашей системы бронирования.	Любое строковое значение
custom_[0-4]	Любой настраиваемый атрибут строкового типа. Они не отображаются пользователям.	Любое строковое значение
hotel_brand	Бренд, которому принадлежит этот отель. Например, «Марриотт» или «Хилтон». Оно не отображается пользователям, но может использоваться для группировки отелей.	Любое строковое значение
lodging	Закодированное представление всех полей, доступных в прототипе Lodging .	Строка в кодировке Base64 закодированного прототипа Lodging
num_reviews	Количество отзывов о листинге.	Любое неотрицательное целое число.
rating	Число с плавающей запятой, представляющее совокупный рейтинг недвижимости.	Обычно это число находится в диапазоне 0–5, 0–10 или 0–100, но вы можете использовать любой диапазон, соответствующий вашей рейтинговой системе. Например, рейтинг объекта должен быть 3 или 4 при шкале рейтинга, равной 5. Примечание. Шкала рейтинга по умолчанию составляет 0–10, если не указана.

Значения заполнителя имя_атрибута для объектов аренды для отпуска

См . атрибуты, специфичные для аренды для отпуска, и пример XML .

<image>

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

Изображения используются для отображения объекта недвижимости в идентификаторе объявления. Все используемые изображения должны соответствовать следующим правилам:

• Рекомендуемое соотношение сторон изображений — 4:3.
• URL-адрес изображения должен быть доступен сканеру изображений Googlebot.

• Если ваш сайт содержит файл robots.txt на корневом уровне, убедитесь, что он содержит один из двух параметров, показанных ниже:

  1. Позволяет сканеру Googlebot сканировать содержимое вашего сайта, включая изображения.

     • Пользовательский агент: Googlebot
     • Позволять: /

  2. Позволяет сканеру изображений Googlebot сканировать изображения на вашем сайте.

     • Пользовательский агент: Googlebot-Image
     • Позволять: /

• Скриншоты изображений или веб-сайтов запрещены. Изображения должны быть оригинальными и актуальными изображениями или фотографиями.

Ключевой момент: только партнеры, настроенные для показа своих изображений конечным пользователям, могут размещать свои изображения на платформах Google. Свяжитесь со своим техническим менеджером по работе с клиентами (TAM), чтобы обновить настройки изображения.

Атрибуты

• "ad" если изображение является рекламой
• "menu" если изображение представляет собой меню ресторана.
• "photo" если изображение является фотографией компании.

Имя атрибута	Необходимый?	Формат	Описание
type	Required	Text	Изображение должно быть одним из следующих:
url	Required	Text	URL-адрес полноразмерного изображения. Используйте атрибут url, чтобы указать изображение, которое будет использоваться на этой странице.
width	Required	A non-negative integer	Ширина изображения в пикселях (рекомендуется более 720 пикселей).
height	Required	A non-negative integer	Высота изображения в пикселях (рекомендуется более 720 пикселей).

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

Ключевой момент: укажите дочерние элементы в порядке, показанном ниже.

Дочерний элемент	Необходимый?	Описание
<link>	Запрошено, но необходимо для местных фото-листингов.	Этот тег содержит действительный и актуальный URL-адрес страницы вашего сайта, на которой находится соответствующее изображение. Он не содержит URL-адрес самого изображения. Пример: <link><http://www.example.com/magic_pizza/></link>
<title>	Запрошено	Этот тег содержит заголовок изображения. Пример: <title>"Luxury Apartment"</title>
<author>	Не требуется	Имя автора контента. Значением может быть имя пользователя или полное имя в формате «Имя Фамилия».
<date>	Необходимый	Этот тег идентифицирует дату создания элемента контента. Вы должны ввести год, месяц и день, как в следующем примере: <date month="6" day="7" year="2023"/>

Пример

В следующем примере показан частичный список отелей с тегами изображений:

<?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>
    <content>
      <review>
      </review>
      <attributes>
      </attributes>
      <image type="photo" url="https://image_url" width="400" height="300">
        <link>https://image_url</link>
        <title>Apartment at Sandstone</title>
        <author>Jessica Landlord</author>
        <date month="6" day="7" year="2023"/>
      </image>
    </content>
  </listing>
  ...
</listings>

Рекомендации по синтаксису

При создании списка отелей на основе XML используйте следующие рекомендации:

• Проверьте XML-файлы списка отелей с помощью схемы XSD Google .

• Используйте кодировку UTF-8. Укажите эту схему кодировки, включив атрибут encoding в тег XML, как показано в примерах ниже.

• Вы можете указать значения данных в своем фиде с помощью разделов CDATA . Если вы используете разделы CDATA , не экранируйте специальные символы.

• Используйте escape-коды для значений данных, которых нет в разделах CDATA , включая URL-адреса. Для представления этих специальных символов можно использовать либо код объекта, либо код символа. В следующей таблице перечислены общие коды объектов и символов, которые вы можете использовать:

  Характер	Сущность	Код символа
  Амперсанд (&)	&	&
  Одинарная кавычка (')	&апос;	'
  Двойная кавычка ("")	"	"
  Больше, чем (>)	>	>
  Меньше чем (<)	&lt;	&#60;

• Опустите элементы XML, которые не содержат данных. Например, если у вас нет широты и долготы отеля, не следует включать пустые элементы <latitude/> и <longitude/> .

• Ни при каких обстоятельствах не используйте HTML в элементах XML (даже если он экранирован).

• Чтобы проверить свой фид перед загрузкой, вы можете использовать локальный XSD-канал http://www.gstatic.com/localfeed/local_feed.xsd.

• Чтобы использовать комментарии в своем канале, оберните комментарий тегами <!-- и --> , как показано в следующем примере:

  <!-- This is a comment -->
  

• Обязательно закройте элемент <date> в пользовательском <review> . Например:

  <date day="2" month="12" year="2017"/>