XML-Referenz für Hotellisten

Eine Hotelliste ist eine oder mehrere XML-Dateien, in denen alle Hotels aufgeführt sind, für die Sie Preisinformationen bereitstellen. Die Hotellistendatei selbst enthält keine Preise. Informationen.

Das Stammelement einer Hotelliste ist das Element <listings>. Es enthält <listing>-Elemente, die Ihre Unterkünfte beschreiben.

Die Hotelliste wird im Rahmen der Erstimplementierung erstellt. und dann im Rahmen der regelmäßigen Wartung Hotels hinzufügen oder entfernen.

Achten Sie darauf, dass Ihre Dateien den Syntaxrichtlinien entsprechen. Verwenden Sie beispielsweise die UTF-8-Codierung und geben Sie dieses Codierungsschema an, indem Sie das Attribut encoding in Ihrem XML-Tag.

Nachdem Sie eine Hotelliste erstellt haben, können Sie sie manuell über das Hotel oder hosten Sie sie auf Ihrem Server.

Datenprobleme finden und beheben

Informationen dazu, wie Sie Datenprobleme in Ihrer Hotelliste finden und beheben, finden Sie in den folgenden Artikeln:

Anforderungen an Einträge

Damit Unterkünfte in Ihrer Hotelliste für Google Hotelanzeigen infrage kommen, müssen sie haben folgende Elemente:

  • Zimmer, in denen zahlende Gäste übernachten können
  • Eine physische Präsenz und einen festen Standort, der für die Öffentlichkeit zugänglich ist
  • Feste Wände und Sanitärinstallationen
  • Einen Mindestaufenthalt von maximal sieben Tagen

Gängige Beispiele für nicht zulässige Unterkünfte sind Kreuzfahrten und Apartments, da sie normalerweise nicht die Kriterien für Listing requirements erfüllen.

Campinghütten und andere Campingunterkünfte mit festen Wänden, Sanitärinstallationen, und Klimatisierung (einschließlich Holzofen oder Propangasheizung) sind zulässig. Nicht zugelassene Outdoor-Unterkünfte sind unter anderem:

  • Campingplätze, auf denen Gäste in Zelten übernachten
  • Wohnmobilparks für Gäste mit eigenem Wohnmobil

<listings>

<listings> ist das Stammelement einer Hotelliste und enthält ein <language>-Element und mindestens ein <listing>-Element.

Das Element <listings> wird an der folgenden Stelle in der Hotelliste angezeigt XML-Hierarchie:

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

Syntax

Das <listings>-Element verwendet die folgende Syntax:

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

Attribute

Das <listings>-Element hat die folgenden Attribute:

Attribut Erforderlich/Optional? Beschreibung
xmlns:xsi Erforderlich Setze diese Property auf http://www.w3.org/2001/XMLSchema-instance.
xsi:noNamespaceSchemaLocation Erforderlich Setze diese Property auf http://www.gstatic.com/localfeed/local_feed.xsd.

Untergeordnete Elemente

Das <listings>-Element hat die folgenden untergeordneten Elemente:

Untergeordnetes Element Erforderlich? Typ Beschreibung
<language> Required string Die Sprache, in der Ihr Feed geschrieben ist. Legen Sie diesen Wert fest: -Element zu einem Sprachcode mit zwei Buchstaben Beispiel: en für Englisch.
<datum> Optional enum Dieses Element gibt das geodätische Datum oder Referenzmodell für Die im Feed angegebenen Breiten- und Längengrade Wenn kein Bezugswert angegeben wird, lautet der Standardwert für dieses Element WGS84, was wird von den meisten modernen GPS-Geräten verwendet. Das Bezugssystem Tokio gilt nur für Adressen in Japan.

Gültige Werte für dieses Element sind:

  • WGS84
  • wgs84
  • TOKYO
  • tokyo
Hinweis:Wenn Sie den Standardwert WGS84 verwenden möchten, geben Sie keine das Element <datum> in der Hotelliste.
<listing> Required <listing> Ein oder mehrere Einträge, die jedes Hotel im Feed beschreiben. Beachten Sie, dass Jedes Hotel in der Liste muss eine eindeutige ID für Ihre Website haben. dass diese ID nicht wiederverwendet werden darf.

Beispiele

Strukturierte Adresse

Das folgende Beispiel zeigt eine nicht vollständige Hotelliste mit einer strukturierten Adresse:

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

Adresse im freien Format

Das folgende Beispiel zeigt eine unvollständige Hotelliste mit freiem Format Adresse:

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

Optionaler Inhalt

Das folgende Beispiel zeigt eine unvollständige Hotelliste mit einem Eintrag, der enthält ein optionales <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>

Eine Hoteldefinition innerhalb eines Hotellistenelements <listings>.

Das Element <listing> wird an der folgenden Stelle in der Hotelliste angezeigt Feed-XML-Hierarchie:

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

Syntax

Das <listing>-Element verwendet die folgende Syntax:

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

Attribute

Das <listing>-Element hat keine Attribute.

Untergeordnete Elemente

Das <listing>-Element hat die folgenden untergeordneten Elemente:

Untergeordnetes Element Erforderlich? Typ Beschreibung
<id> Required string Eine eindeutige Kennung für das Hotel.

Hinweis: Dieser Wert muss für Ihre Website immer eindeutig sein. Das sollten Sie tun: keine wiederverwendeten IDs, da dies zu Problemen führen kann, Probleme bei der Zuordnung von Unterkünften beheben
<name> Required string Der Name des Hotels. Beispiel: 
<name>Belgrave House</name>
<address> Required Object or string

Der vollständige Standort des Hotels.

Dieses Element verwendet das einzelne Attribut format, das Sie muss auf simple festgelegt sein.

Sie müssen mindestens Straße, Ort, Bundesland oder Region angeben. und die Postleitzahl des Hotels. <component> untergeordnetes Konto verwenden Elemente zur Beschreibung der folgenden Teile der Adresse:

  • addr1: Die primäre Adresse des Hotels.
  • addr2: Die sekundäre Adresse, falls erforderlich.
  • addr3: ein dritter Teil der Adresse, falls notwendig ist.
  • city: Der Name der Stadt, in der sich das Hotel befindet.
  • province: Der Name des Bundesstaats, der Region oder des Hotels. Bundesland
  • postal_code: Die Postleitzahl des Hotels.

Beispiel:

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

Alternativ können Sie das Format im freien Format angeben. Adresse, obwohl dies wird nicht empfohlen. Beispiel:

<address>6 Elm Ave Unit 3, Boston, MA, 02472</address>

Beachten Sie, dass PO- oder andere Adressen, die nur der Postzustellung dienen, als vollständige physische Adressen gelten.
<country> Required string Das Land, in dem sich dieser Eintrag befindet. Der Wert muss ein aus zwei Buchstaben bestehenden Ländercode. Für die USA lautet der Code beispielsweise "US", für Kanada "CA". For example: 
<country>US</country>
<latitude> Required* float Der Breitengrad, der dem Standort des Hotels entspricht. Für Beispiel: 
<latitude>37.423738</latitude>

Dieser Wert kann mit GeoCoding-Tools wie dem Google Maps API
<longitude> Required* float Der Längengrad, der dem Standort des Hotels entspricht. Für Beispiel: 
<longitude>-122.090101</longitude>

Dieser Wert kann mit GeoCoding-Tools wie dem Google Maps API
<location_precision> Optional integer Die Genauigkeit des Standorts der Unterkunft in Metern, wenn der Breiten- und Längengrad des Attributs verschleiert wird. Null (0) bedeutet, dass es keine Verschleierung gibt und es sich um den genauen Standort handelt. Hinweis : Dieses Element gilt nur für Ferienunterkünfte.
<phone> Required* string

Eine oder mehrere Kontaktnummern für das Hotel. Wenn es sich bei dem Eintrag um ein Unternehmensprofil handelt Zweigstelle, geben Sie die für die Zweigstelle spezifische Telefonnummer an (nicht die Telefonnummer des Hauptsitzes).

Das type-Attribut kann einer der folgenden Werte sein:

  • fax: Faxnummer.
  • main: Haupttelefonnummer.
  • mobile: Mobiltelefonnummer.
  • tdd: Telekommunikationsgerät für Gehörlose (TDD) Telefonnummer.
  • tollfree: Gebührenfreie Telefonnummer

Beispiel:

<!-- Singapore (country code +65) -->
<phone type="main">+65 6722-2323</phone>
<!-- U.S. (country code +1) -->
<phone type="fax">+1 408-555-1111</phone>

Sie müssen mindestens einen main-Typ angeben.
<category> Optional string Die Art der Unterkunft, z. B. ein Hotel. Partner können beliebige interne Kategorien, mit denen sie ihre Unterkunft beschreiben müssen, z. B. „Businesshotels“, „Resorts“ „Motels“ und Ähnliches.
<content> Optional <content> Optionale Details für den Eintrag, z. B. Beschreibung, Bewertungen, und Merkmale der Immobilie.

* Es ist entweder eine Telefonnummer oder ein Breiten-/Längengrad erforderlich. Mi. empfehlen, beide zu definieren.

Beispiele

Strukturierte Adresse

Das folgende Beispiel zeigt eine nicht vollständige Hotelliste mit einer strukturierten Adresse:

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

Adresse im freien Format

Das folgende Beispiel zeigt eine unvollständige Hotelliste mit freiem Format Adresse:

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

Optionaler Inhalt

Das folgende Beispiel zeigt eine unvollständige Hotelliste mit einem Eintrag, der enthält ein optionales <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>

Fügt Informationen zu einem Eintrag hinzu, z. B. Bewertungen und Rezensionen, Ausstattung und weitere Details. Das <content>-Element ist optional. Innerhalb von <content>, Alle untergeordneten Elemente sind optional.

Das Element <content> wird an der folgenden Stelle in der Hotelliste angezeigt Feed-XML-Hierarchie:

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

Syntax

Das <content>-Element verwendet die folgende Syntax:

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

Attribute

Das <content>-Element hat keine Attribute.

Untergeordnete Elemente

Das <content>-Element hat die folgenden untergeordneten Elemente:

Untergeordnetes Element Erforderlich? Typ Beschreibung
<text type="description"> Optional Object

Die mit dem Eintrag des Anbieters verknüpfte Webseite. Diese weist die folgenden untergeordneten Elemente auf:

  • <link>: Ein Link zur Beschreibung. Fügen Sie die „http://“ oder
    „https://“ in diesem Element (optional).
  • <title>: Der Titel der Beschreibung (optional)
  • <author>: Der Autor der Beschreibung (optional)
  • <body>: Der Text der Beschreibung (erforderlich).
  • <date>: Das Datum der Beschreibung (optional).

    • Hinweis: Diese Elemente müssen in der oben angegebenen Reihenfolge angezeigt werden.
<review type="[editorial|user]"> Optional <review>

Enthält eine Nutzerrezension oder eine redaktionelle Rezension des Eintrags. Ihr Eintrag kann beliebig viele Beurteilungen beider Art enthalten.

Sie müssen nicht alle Rezensionen für eine Unterkunft in Ihre <listing>-Element; sollten Sie dieses Element ausgewählte Beurteilungen, die die Merkmale oder Funktionen dieses Eintrags die Qualität zu verbessern.
<attributes> Optional Object

Enthält 0 oder mehr untergeordnete <client_attr>-Elemente, die Details zur Unterkunft angeben. Die untergeordneten Elemente verwenden Folgendes: Syntax:

<client_attr name="attribute_name">attribute_value<client_attr>

Eine Liste und Beschreibung untergeordneter Elemente finden Sie unter <attributes>

Alle <client_attr>-Elemente sind optional.

Wenn ein untergeordnetes <website>-Element vorhanden ist, muss es vor jedem <client_attr>-Element platziert wird.
<image> Optional Object Wiederkehrendes Tag, enthält detaillierte Bildinformationen.

Beispiel

Das folgende Beispiel zeigt eine unvollständige Hotelliste mit <content>-Element:

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

Enthält eine Nutzerrezension oder eine redaktionelle Rezension. Sie müssen nicht alle Rezensionen für einen Eintrag in deinem <listing>-Element ist dieses Element für Sie ausgewählte Rezensionen einbeziehen, die auf die Merkmale dieses Eintrags hinweisen oder Qualität haben.

Das Element <review> wird an der folgenden Stelle in der Hotelliste angezeigt Feed-XML-Hierarchie:

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

Syntax

Das <review>-Element verwendet die folgende Syntax:

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

Attribute

Das <review>-Element hat die folgenden Attribute:

Attribut Erforderlich/Optional? Beschreibung
type Required Die Art der Rezension. Legen Sie dafür einen der folgenden Werte fest: <ph type="x-smartling-placeholder">
    </ph>
  • editorial: Eine Rezension einer Website oder eines anderen Erfahrungsberichts Befugnis.
  • user: Eine Rezension eines Endnutzers.

Untergeordnete Elemente

Das <review>-Element hat die folgenden untergeordneten Elemente:

Untergeordnetes Element Erforderlich? Typ Beschreibung
<link> Optional string Ein Link zur Rezension. Geben Sie "http://" mit oder „https://“ in diesem -Elements.
<title> Optional string (Nur redaktionelle Rezensionen) Der Titel der Rezension.
<author> Optional string Den Autor der Rezension z. B. "Susan von Trapp". Dies kann auch den Namen der Website oder Veröffentlichung, auf der die Rezension erscheint, ist nicht kreditiert.
<rating> Optional string Eine Gleitkommazahl zwischen 0 und 10 (einschließlich), die das Ereignis der Rezension. Beispiel: „8.9“.
<body> Optional string Der Text der Rezension. Dieses Element sollte kein HTML enthalten.
<date month="MM" day="DD" year="YYYY"/> Optional Object (Nur Nutzerrezensionen) Das Datum der Rezension, das Sie in den folgende Attribute dieses Elements: <ph type="x-smartling-placeholder">
    </ph>
  • day: Der Tag des Monats. zum Beispiel „7“.
  • month: Der Monat, wobei 1 = Januar ... 12 = Dezember.
  • year: das vierstellige Jahr. Beispiel: „2023“.

Der 7. Juni 2023 wird beispielsweise so geschrieben:

<date month="6" day="7" year="2023"/>
<servicedate month="MM" day="DD" year="YYYY"/> Optional Object (Nur Nutzerrezensionen) Das Datum, an dem der Rezensent den rezensierten Eintrag aufgerufen hat. Das Format ist dasselbe wie <date>. oben.

Der 7. Juni 2023 wird beispielsweise so geschrieben:

<servicedate month="6" day="7" year="2023"/>

Rezensionen ohne mindestens Monat und Jahr von <servicedate> wird möglicherweise nicht angezeigt. Der Tag ist nicht erforderlich.

Beachten Sie, dass <title> nur dann ein gültiges untergeordnetes Element von <review> ist, wenn das type der Rezension ist editorial und <date> ist nur gültig, wenn type den Wert user hat.

Beispiel

Das folgende Beispiel zeigt eine unvollständige Hotelliste mit einem Eintrag, der enthält eine redaktionelle und eine Nutzerrezension:

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

Mit dem Tag <attributes> können Sie die Ausstattung der Unterkunft beschreiben und Bewertungen und Rezensionen der Immobilie klassifizieren.

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

Untergeordnete Elemente

Untergeordnetes Element Erforderlich? Beschreibung
<website> Optional Die primäre Website für das Hotel. Falls vorhanden, muss die Position vor dem ersten <client_attr>-Element hinzu. Beispiel: 
<website>https://hotel.example.com</website>
<client_attr name="attribute_name"> Optional Ein zusätzliches Merkmal oder „Attribut“ der Immobilie, die kann mithilfe der unterstützten attribute_name oder attribute_name für Ferienunterkünfte.

Werte für den Platzhalter „attribute_name“

In der folgenden Tabelle sind die gültigen Werte für attribute_name aufgeführt in <client_attr name="attribute_name"> -Elements.

Werte für attribute_name Beschreibung Gültige Inhaltswerte
alternate_hotel_id Eine alternative Kennung für Ihre Unterkunft. Die Verwendung separater IDs ist nützlich wenn Sie eine Unterkunfts-ID für Ihre Feedinformationen benötigen eine andere Unterkunfts-ID für Ihr Buchungssystem. Beliebiger Stringwert
custom_[0-4] Ein beliebiges benutzerdefiniertes Attribut vom Typ Stringtyp. Diese werden Nutzern nicht angezeigt. Beliebiger Stringwert
hotel_brand Die Kette, zu der dieses Hotel gehört. Beispiel: „Marriott“ oder „Hilton“. Wird Nutzern nicht angezeigt, kann aber zum Gruppieren verwendet werden Hotels Beliebiger Stringwert
lodging Codierte Darstellung aller verfügbaren Felder im Lodging proto zu erstellen ist. Base64-codierter String des codiert Lodging Proto
num_reviews Anzahl der Rezensionen des Eintrags Beliebige nicht negative Ganzzahl.
rating Eine Gleitkommazahl, die die aggregierte Unterkunftsbewertung darstellt. Diese Zahl liegt normalerweise zwischen 0 und 5, 0 bis 10 oder 0 bis 100, aber können Sie jeden beliebigen Bereich verwenden, der Ihr Bewertungssystem darstellt.

Werte für den Platzhalter „attribute_name“ für Ferienunterkünfte

Weitere Informationen finden Sie unter Attribute für Ferienunterkünfte und XML-Beispiel.

<image>

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

Bilder werden verwendet, um die Unterkunft in der Eintrags-ID zu präsentieren. Alle verwendeten Bilder müssen befolgen Sie diese Richtlinien:

  • Das empfohlene Seitenverhältnis für Bilder ist 4:3.
  • Der Googlebot-Bild-Crawler muss auf die Bild-URL zugreifen können.

  • Wenn Ihre Website eine robots.txt-Datei auf Stammebene enthält, überprüfen Sie, ob sie eine der beiden folgenden Optionen:

    1. Erlaubt dem Googlebot-Crawler, den Content und die Bilder auf Ihrer Website zu crawlen.

      • User-agent: Googlebot
      • Allow: /

    2. Erlaubt dem Googlebot-Bild-Crawler, die Bilder auf Ihrer Website zu crawlen.

      • User-agent: Googlebot-Image
      • Allow: /

  • Screenshots von Bildern oder Websites sind nicht zulässig. Bilder müssen Originale sein und tatsächliche Bilder oder Fotos.

Attribute

  • "ad", wenn das Bild eine Werbeanzeige ist
  • "menu", wenn das Bild eine Speisekarte zeigt
  • "photo", wenn das Bild ein Foto des Unternehmens ist
Attributname Erforderlich? Format Beschreibung
type Required Text

Folgende Bilder sind zulässig:
url Required Text Die URL des Bildes in Originalgröße. Verwenden Sie das URL-Attribut, um anzugeben, das Bild, das auf dieser Seite verwendet werden soll.
width Required A non-negative integer Die Breite des Bildes in Pixeln (mehr als 720 Pixel ist empfohlen)
height Required A non-negative integer Die Höhe des Bildes in Pixeln (mehr als 720 Pixel ist empfohlen)

Untergeordnete Elemente

Untergeordnetes Element Erforderlich? Beschreibung
<link> Angefordert, aber erforderlich für lokale Fotoeinträge. Dieses Tag enthält die gültige und aktuelle URL der Seite auf Ihrer Website ob das entsprechende Bild zu sehen ist. Die URL für das Bild selbst ist nicht enthalten. Beispiel:
<link><http://www.example.com/magic_pizza/></link>
<title> Angefordert Dieses Tag enthält den Titel des Bildes. Beispiel: 
<title>"Luxury Apartment"</title>
<author> Nicht erforderlich Der Name des Autors des Inhalts. Der Wert kann entweder ein Nutzername oder ein vollständiger Name im Format „Vorname Nachname“ sein.
<date> Erforderlich

Dieses Tag gibt das Datum an, an dem das Inhaltselement erstellt wurde. Ich müssen wie im folgenden Beispiel Jahr, Monat und Tag eingegeben werden:

<date month="6" day="7" year="2023"/>

Beispiel

Das folgende Beispiel zeigt eine unvollständige Hotelliste mit Bild-Tags:

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

Syntaxrichtlinien

Beachten Sie beim Erstellen einer XML-basierten Hotelliste die folgenden Richtlinien:

  • Validieren Sie Ihre Hotellisten-XML-Dateien mit dem XSD-Schema von Google.

  • Verwenden Sie die UTF-8-Codierung. Geben Sie dieses Codierungsschema an, indem Sie encoding einschließen in Ihrem XML-Tag verwenden, wie in den folgenden Beispielen gezeigt.

  • Sie können Datenwerte in Ihrem Feed mit CDATA-Abschnitten angeben. Wenn Sie CDATA-Abschnitte verwenden, kein Escapezeichen für Sonderzeichen verwenden.

  • Verwenden Sie Escape-Codes für Datenwerte, die sich nicht in den CDATA-Abschnitten befinden, einschließlich URLs. Sie können entweder den Entitätscode oder den Zeichencode verwenden, um Sonderzeichen einfügen. In der folgenden Tabelle sind gängige Entitäts- und Zeichencodes aufgeführt, die Sie verwenden können:

    Zeichen Entität Zeichencode
    Kaufmännisches Und-Zeichen (&) &amp; &#38;
    Einfaches Anführungszeichen (') &apos; &#39;
    Doppeltes Anführungszeichen (") &quot; &#34;
    Größer als (>) &gt; &#62;
    Kleiner als (<) &lt; &#60;

  • Lassen Sie XML-Elemente aus, die keine Daten enthalten. Wenn Sie beispielsweise keine Breiten- und Längengrad eines Hotels angeben, darf kein leeres Feld <latitude/>- und <longitude/>-Elemente.

  • Verwenden Sie in Ihren XML-Elementen unter keinen Umständen HTML, selbst wenn es mit Escapezeichen versehen).

  • Um Ihren Feed vor dem Hochladen zu validieren, können Sie die lokale Feed-XSD verwenden. http://www.gstatic.com/localfeed/local_feed.xsd.

  • Wenn Sie Kommentare in Ihrem Feed verwenden möchten, umschließen Sie den Kommentar in die Tags <!-- und -->. wie das folgende Beispiel zeigt:

    <!-- This is a comment -->

  • Achten Sie darauf, das <date>-Element in einem Nutzer zu schließen <review> Beispiel:

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