XML-Referenz für Hotellisten

Eine Hotelliste besteht aus einer oder mehreren XML-Dateien, in denen alle Hotels aufgeführt sind, für die Sie Preisinformationen bereitstellen. Die Hotellistendatei selbst enthält keine Preisinformationen.

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

Sie erstellen im Rahmen der ersten Implementierung eine Hotelliste und fügen im Rahmen der regelmäßigen Wartung Hotels hinzu oder entfernen sie daraus.

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 Ihr XML-Tag aufnehmen.

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

Datenprobleme finden und beheben

Informationen zum Ermitteln und Beheben von Datenproblemen in Ihrer Hotelliste finden Sie in den folgenden Artikeln:

• Hotelinventar einrichten
• Probleme bei der Unterkunftszuordnung beheben

Anforderungen an Einträge

Unterkünfte in Ihrer Hotelliste müssen folgende Voraussetzungen erfüllen, um für Google Hotelanzeigen infrage zu kommen:

• 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

Häufige Beispiele für unzulässige Unterkünfte sind Kreuzfahrten und Apartments, weil sie in der Regel nicht die Listing requirements-Kriterien erfüllen.

Campinghütten und andere Campingeinrichtungen mit festen Wänden, Sanitärinstallationen und Klimaanlage (einschließlich Holzofen oder Propanheizung) sind zulässig. Nicht infrage kommende Unterkünfte im Freien:

• Campingplätze, auf denen Gäste in Zelten übernachten
• Wohnmobilparks, in denen Gäste ihr eigenes Wohnmobil mitbringen

<listings>

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

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

+ <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 für den Wert dieses Elements einen aus zwei Buchstaben bestehenden Sprachcode fest. Beispiel: en für Englisch.
<datum>	Optional	enum	Mit diesem Element wird das geodätische Bezugsmodell oder das Referenzmodell für die im Feed angegebenen Breiten- und Längengradkoordinaten angegeben. Wenn kein Bezugswert angegeben ist, ist der Standardwert für dieses Element WGS84, der von den meisten modernen GPS-Geräten verwendet wird. Das Tokio-Bezugssystem 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, nehmen Sie das Element <datum> nicht in die Hotelliste auf.
<listing>	Required	<listing>	Ein oder mehrere Einträge, die jedes Hotel im Feed beschreiben. Beachten Sie, dass jedes Hotel in der Liste eine eindeutige ID für Ihre Website haben muss und dass diese ID nie wiederverwendet werden sollte.

Beispiele

Strukturierte Adresse

Das folgende Beispiel zeigt eine unvollstä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 einer Adresse im freien Format:

<?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, 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 nicht vollständige Hotelliste mit einem Eintrag, der ein optionales <content> enthält:

<?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> ist an der folgenden Stelle in der XML-Hierarchie des Hotellistenfeeds zu sehen:

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

Wichtiger Hinweis :Geben Sie die untergeordneten Elemente in der unten gezeigten Reihenfolge an.

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. Verwenden Sie IDs nicht noch einmal, da dies beim Versuch, Probleme bei der Zuordnung von Unterkünften zu beheben, zu Problemen führen kann.
<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 auf simple festlegen müssen. Sie müssen mindestens die Adresse, den Ort, das Bundesland oder die Region und die Postleitzahl des Hotels angeben. Verwenden Sie untergeordnete <component>-Elemente, um die folgenden Teile der Adresse zu beschreiben: addr1: Die primäre Adresse des Hotels. addr2: Die sekundäre Adresse, falls erforderlich. addr3: Ein dritter Teil der Adresse, falls erforderlich. city: Name der Stadt, in der sich das Hotel befindet. province: Name des Bundeslands, der Region oder der Provinz des Hotels. postal_code: 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 eine Adresse im freien Format angeben. Dies wird jedoch nicht empfohlen. Beispiel: <address>6 Elm Ave, Boston, MA, 02472</address> Postfächer und andere Adressen, die nur der Postzustellung dienen, gelten nicht als vollständige Postanschriften.
<country>	Required	string	Das Land, in dem sich dieser Eintrag befindet. Der Wert muss ein aus zwei Buchstaben bestehender Ländercode sein. Für die USA lautet der Code beispielsweise "US", für Kanada "CA". Beispiel: <country>US</country>
<latitude>	Required*	float	Der Breitengrad, der dem Standort des Hotels entspricht. Beispiel: <latitude>37.423738</latitude> Dieser Wert kann mit GeoCoding-Tools wie der Google Maps API generiert werden.
<longitude>	Required*	float	Der Längengrad, der dem Standort des Hotels entspricht. Beispiel: <longitude>-122.090101</longitude> Dieser Wert kann mit GeoCoding-Tools wie der Google Maps API generiert werden.
<location_precision>	Optional	integer	Genauigkeit des Standorts der Unterkunft in Metern, wenn Breiten- und Längengrad des Objekts verschleiert sind. Null (0) bedeutet, dass keine Verschleierung vorliegt und es sich um den exakten 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 eine Unternehmensfiliale handelt, geben Sie bitte die Telefonnummer des Standorts an (nicht die Telefonnummer der Hauptniederlassung). Das type-Attribut kann eines der folgenden Attribute sein: fax: Faxnummer. main: Haupttelefonnummer für Anrufe. mobile: Mobiltelefonnummer. tdd: Telefonnummer für Telekommunikationsgeräte für Gehörlose. tollfree: Gebührenfreie Telefonnummer. Beispiel: <!-- Singapore (country code +65) --> <phone type="main">[phone]</phone> <!-- U.S. (country code +1) --> <phone type="fax">[phone]</phone> Sie sollten mindestens den Typ main angeben.
<category>	Optional	string	Die Art der Unterkunft, z. B. ein Hotel. Partner können alle internen Kategorien verwenden, die sie zur Beschreibung ihrer Unterkunft haben, z. B. „Businesshotels“, „Resorts“, „Motels“ und Ähnliches.
<content>	Optional	<content>	Optionale Details für den Eintrag, z. B. eine Beschreibung, Bewertungen und Merkmale der Unterkunft.

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

Beispiele

Strukturierte Adresse

Das folgende Beispiel zeigt eine unvollstä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 einer Adresse im freien Format:

<?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, 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 nicht vollständige Hotelliste mit einem Eintrag, der ein optionales <content> enthält:

<?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, Rezensionen, Ausstattung und andere Details. Das <content>-Element ist optional. Innerhalb von <content> sind alle untergeordneten Elemente optional.

Das Element <content> ist an der folgenden Stelle in der XML-Hierarchie des Hotellistenfeeds zu sehen:

+ <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 Webseite, die mit dem Eintrag des Anbieters verknüpft ist. Diese weist die folgenden untergeordneten Elemente auf: <link>: Ein Link zur Beschreibung. Geben Sie in diesem Element „http://“ oder „https://“ an (optional). <title>: Der Titel für die 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 Rezensionen beider Arten enthalten. Du musst nicht alle Rezensionen für eine Unterkunft in das Element <listing> aufnehmen. Mit diesem Element kannst du ausgewählte Rezensionen hinzufügen, die die Funktionen oder Qualität dieses Eintrags veranschaulichen.
<attributes>	Optional	Object	Enthält 0 oder mehr untergeordnete <client_attr>-Elemente, die Details zum Attribut enthalten. Die untergeordneten Elemente verwenden die folgende Syntax: <client_attr name="attribute_name">attribute_value<client_attr> Eine Liste und eine Beschreibung der untergeordneten 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 positioniert werden.
<image>	Optional	Object	Wiederkehrendes Tag, das detaillierte Bildinformationen enthält.

Beispiel

Das folgende Beispiel zeigt eine nicht vollständige Hotelliste, die das Element <content> enthält:

<?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 das Element <listing> aufnehmen. Dieses Element ist für ausgewählte Rezensionen vorgesehen, die auf die Funktionen oder Qualität dieses Eintrags hinweisen.

Das Element <review> ist an der folgenden Stelle in der XML-Hierarchie des Hotellistenfeeds zu sehen:

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

Wichtiger Hinweis: Bevor Rezensionen von Drittanbietern in Google integriert werden können, musst du eine Inhalte-Lizenzvereinbarung (CLA) abschließen. Lesen Sie den Artikel Rezensionen von Drittanbietern an Google senden und wenden Sie sich an Ihren Account Manager für den Vertrieb, um weitere Informationen zu erhalten.

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 Überprüfung. Legen Sie einen der folgenden Werte fest: editorial: Eine Rezension durch eine Website oder eine andere Prüfstelle. user: Eine Rezension eines Endnutzers.

Untergeordnete Elemente

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

Wichtiger Hinweis :Geben Sie die untergeordneten Elemente in der unten gezeigten Reihenfolge an.

Untergeordnetes Element	Erforderlich?	Typ	Beschreibung
<link>	Optional	string	Link zur Rezension Geben Sie in diesem Element „http://“ oder „https://“ an.
<title>	Optional	string	(Nur redaktionelle Rezensionen) Der Titel der Rezension.
<author>	Optional	string	Der Autor der Rezension, z. B. „Susan von Trapp“. Dies kann auch der Name einer Website oder Publikation sein, in der die Rezension erscheint, wenn sie nicht als Mitwirkender genannt wird.
<rating>	Optional	string	Eine Gleitkommazahl zwischen 0 und 10 (einschließlich), die die Bewertung der Rezension darstellt. Beispiel: „8.9“.
<body>	Optional	string	Der Text der Rezension. Dieses Element sollte keinen HTML-Code enthalten.
<date month="MM" day="DD" year="YYYY"/>	Optional	Object	(Nur Nutzerrezensionen) Das Datum der Rezension, das Sie mit den folgenden Attributen dieses Elements angeben: day: Der Tag des Monats, z. B. „7“. month: Der Monat, wobei 1 = Januar ... 12 = Dezember. year: vierstellige Jahreszahl, z. B. „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 mit dem obigen <date> identisch. Der 7. Juni 2023 wird beispielsweise so geschrieben: <servicedate month="6" day="7" year="2023"/> Rezensionen, für die nicht mindestens Monat und Jahr angegeben sind, werden unter Umständen nicht angezeigt. Tag ist nicht erforderlich.

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

Beispiel

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

<?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 Unterkunft klassifizieren.

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

Wichtig: Alle Attribute sind optional.

Untergeordnete Elemente

Untergeordnetes Element	Erforderlich?	Beschreibung
<website>	Optional	Die primäre Website des Hotels. Falls vorhanden, muss es vor dem ersten <client_attr>-Element positioniert werden. Beispiel: <website>https://hotel.example.com</website>
<client_attr name="attribute_name">	Optional	Ein zusätzliches Merkmal oder „Attribut“ der Unterkunft, das mit dem unterstützten attribute_name oder attribute_name für Ferienunterkünfte angegeben werden kann.

Werte für den Platzhalterattribute_name

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

Werte für attribute_name	Beschreibung	Gültige Inhaltswerte
alternate_hotel_id	Eine alternative Kennung für Ihre Unterkunft. Separate IDs sind nützlich, wenn Sie unter Umständen eine Unterkunfts-ID für Ihre Feedinformationen und eine weitere Unterkunfts-ID für Ihr Buchungssystem benötigen.	Beliebiger Stringwert
custom_[0-4]	Beliebiges benutzerdefiniertes Attribut vom Typ „String“. Sie werden Nutzern nicht angezeigt.	Beliebiger Stringwert
hotel_brand	Die Kette, zu der dieses Hotel gehört. Beispiel: „Marriott“ oder „Hilton“. Er wird Nutzern nicht angezeigt, kann aber zum Gruppieren von Hotels verwendet werden.	Beliebiger Stringwert
lodging	Codierte Darstellung aller im Lodging-Proto verfügbaren Felder.	Base64-codierter String des codierten Lodging-Protokolls
num_reviews	Anzahl der Rezensionen des Eintrags.	Beliebige nicht negative Ganzzahl.
rating	Eine Gleitkommazahl, die die Gesamtbewertung der Unterkunft darstellt.	Diese Zahl liegt normalerweise zwischen 0–5, 0–10 oder 0–100. Sie können aber auch einen beliebigen Bereich verwenden, der Ihr Bewertungssystem darstellt.

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

Weitere Informationen finden Sie unter Spezifische 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 darzustellen. Alle verwendeten Bilder müssen den folgenden Richtlinien entsprechen:

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

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

  1. Der Googlebot-Crawler kann den Inhalt Ihrer Website einschließlich Bildern crawlen.

     • User-agent: Googlebot
     • Allow: /

  2. Erlaubt dem Googlebot-Image-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 Original- und echte Bilder oder Fotos sein.

Wichtiger Hinweis: Nur Partner, die so konfiguriert sind, dass sie Endnutzern ihre Bilder anzeigen, können ihre Bilder auf Google-Oberflächen auflisten lassen. Wenden Sie sich an Ihren Technical Account Manager (TAM), um Ihre Image-Einstellungen zu aktualisieren.

Attribute

• "ad", wenn das Bild eine Anzeige ist
• "menu", wenn das Bild eine Speisekarte ist
• "photo", wenn das Bild ein Foto des Unternehmens ist

Attributname	Erforderlich?	Format	Beschreibung
type	Required	Text	Bei einem Bild muss es sich um eines der folgenden Formate handeln:
url	Required	Text	Die URL des Bildes in voller Größe. Verwenden Sie das URL-Attribut, um das Bild anzugeben, das auf dieser Seite verwendet werden soll.
width	Required	A non-negative integer	Breite des Bildes in Pixeln (mehr als 720 Pixel werden empfohlen)
height	Required	A non-negative integer	Höhe des Bildes in Pixeln (mehr als 720 Pixel werden empfohlen)

Untergeordnete Elemente

Wichtiger Hinweis :Geben Sie die untergeordneten Elemente in der unten gezeigten Reihenfolge an.

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 deiner Website, auf der sich das relevante Bild befindet. Sie enthält nicht die URL für das Bild selbst. 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 der Inhalte. Der Wert kann entweder ein Nutzername oder ein vollständiger Name im Format „Vorname Nachname“ sein.
<date>	Erforderlich	Dieses Tag gibt das Erstellungsdatum des Inhaltselements an. Sie müssen wie im folgenden Beispiel ein Jahr, einen Monat und einen Tag eingeben: <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 das Attribut encoding wie in den folgenden Beispielen gezeigt in Ihr XML-Tag einfügen.

• Sie können Datenwerte in Ihrem Feed mit CDATA-Abschnitten angeben. Wenn Sie CDATA-Abschnitte verwenden, müssen Sie Sonderzeichen nicht mit Escapezeichen versehen.

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

  Figur	Entität	Zeichencode
  Kaufmännisches Und-Zeichen (&)	&	&
  Einfaches Anführungszeichen (')	'	'
  Doppeltes Anführungszeichen (")	"	"
  Größer als (>)	>	>
  Kleiner als (<)	&lt;	&#60;

• Lassen Sie XML-Elemente aus, die keine Daten enthalten. Wenn Sie beispielsweise den Breiten- und Längengrad für ein Hotel nicht kennen, sollten Sie keine leeren <latitude/>- und <longitude/>-Elemente einfügen.

• Verwenden Sie in Ihren XML-Elementen unter keinen Umständen HTML, auch wenn es in Escape-Zeichen gesetzt ist.

• Um Ihren Feed vor dem Hochladen zu validieren, können Sie den lokalen 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 wie im folgenden Beispiel in <!--- und -->-Tags:

  <!-- This is a comment -->
  

• Achten Sie darauf, dass Sie das <date>-Element in einem <review> des Nutzers schließen. Beispiel:

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