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">+65 6722-2323</phone>
<!-- U.S. (country code +1) -->
<phone type="fax">+1 408-555-1111</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>

Синтаксис

Элемент <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
      • Позволять: /

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

Атрибуты

  • "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-адреса. Для представления этих специальных символов можно использовать либо код объекта, либо код символа. В следующей таблице перечислены общие коды объектов и символов, которые вы можете использовать:

    Характер Сущность Код символа
    Амперсанд (&) &amp; &#38;
    Одинарная кавычка (') &апос; &#39;
    Двойная кавычка ("") &quot; &#34;
    Больше, чем (>) &gt; &#62;
    Меньше чем (<) &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"/>
,

Список отелей – это один или несколько 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">+65 6722-2323</phone>
<!-- U.S. (country code +1) -->
<phone type="fax">+1 408-555-1111</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>

Синтаксис

Элемент <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
      • Позволять: /

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

Атрибуты

  • "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-адреса. Для представления этих специальных символов можно использовать либо код объекта, либо код символа. В следующей таблице перечислены общие коды объектов и символов, которые вы можете использовать:

    Характер Сущность Код символа
    Амперсанд (&) &amp; &#38;
    Одинарная кавычка (') &апос; &#39;
    Двойная кавычка ("") &quot; &#34;
    Больше, чем (>) &gt; &#62;
    Меньше чем (<) &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"/>