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 angeben. Die Hotellistendatei selbst enthält keine Preisinformationen.

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

Sie erstellen eine Hotelliste im Rahmen Ihrer Erstimplementierung 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 dazu, wie Sie Datenprobleme in Ihrer Hotelliste finden und beheben, finden Sie in den folgenden Artikeln:

• Hotelinventar einrichten
• Probleme bei der Zuordnung von Unterkünften beheben

Anforderungen an Einträge

Um sich für Google Hotelanzeigen zu qualifizieren, müssen Unterkünfte in Ihrer Hotelliste die folgenden Anforderungen erfüllen:

• 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, weil sie normalerweise nicht die Kriterien für Listing requirements erfüllen.

Campinghütten und andere Campingeinrichtungen mit festen Wänden, Sanitärinstallationen und Klimaanlagen (einschließlich Holzofen oder Propanheizung) 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 XML-Hierarchie der Hotelliste 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 den Wert dieses Elements auf einen aus zwei Buchstaben bestehenden Sprachcode fest. Beispiel: en für Englisch.
<datum>	Optional	enum	Mit diesem Element wird das geodätische Datum oder das Referenzmodell für die im Feed angegebenen Breiten- und Längengrade angegeben. Wenn kein Bezugswert angegeben ist, wird für dieses Element der Standardwert WGS84 verwendet. Dieser 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, fügen Sie das Element <datum> nicht in die Hotelliste ein.
<listing>	Required	<listing>	Ein oder mehrere Einträge, die jedes Hotel im Feed beschreiben. Jedes Hotel in der Liste muss eine eindeutige ID für Ihre Website haben. Diese ID darf nicht wiederverwendet werden.

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 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 einen optionalen <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> wird an der folgenden Stelle in der XML-Hierarchie des Hotellistenfeeds angezeigt:

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

Wichtig: 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 wieder, da dies zu Problemen beim Beheben von Problemen bei der Zuordnung von Unterkünften 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 auf simple festgelegt werden muss. Sie müssen mindestens die Adresse, die Stadt, das Bundesland oder die Region und die Postleitzahl des Hotels angeben. Verwenden Sie untergeordnete <component>-Elemente, um jeden der 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: Der Name der Stadt, in der sich das Hotel befindet. province: Der Name des Bundeslands, der Region oder der Provinz des Hotels. 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 eine Adresse im freien Format angeben. Dies wird jedoch nicht empfohlen. Beispiel: <address>6 Elm Ave Unit 3, Boston, MA, 02472</address> Postfächer und andere Adressen, die nur der Postzustellung dienen, gelten nicht als vollständige physische Adressen.
<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". For example: <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	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 eine Unternehmensfiliale handelt, geben Sie die Telefonnummer des Standorts der Filiale an (nicht die Telefonnummer des Hauptsitzes). Das type-Attribut kann einer der folgenden Werte sein: fax: Faxnummer. main: Haupttelefonnummer. mobile: Mobiltelefonnummer. tdd: Telefonnummer für Telekommunikationsgerät für Gehörlose (TDD). 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 müssen mindestens einen main-Typ angeben.
<category>	Optional	string	Die Art der Unterkunft, z. B. ein Hotel. Partner können beliebige interne Kategorien verwenden, die sie zur Beschreibung ihrer Unterkunft haben, z. B. „Businesshotels“, „Resorts“, „Motels“ usw.
<content>	Optional	<content>	Optionale Details für den Eintrag, z. B. Beschreibung, Bewertungen und Ausstattung der Unterkunft.

* Es ist entweder eine Telefonnummer oder ein Breiten-/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 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 einen optionalen <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> wird an der folgenden Stelle in der XML-Hierarchie des Hotellistenfeeds angezeigt:

+ <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. Geben Sie in diesem Element „http://“ oder „https://“ an (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 Rezensionen beider Arten enthalten. Sie müssen nicht alle Rezensionen für eine Unterkunft in das Element <listing> aufnehmen. Mit diesem Element sollen ausgewählte Rezensionen hinzugefügt werden, die die Merkmale oder Qualität dieses Eintrags veranschaulichen.
<attributes>	Optional	Object	Enthält 0 oder mehr untergeordnete <client_attr>-Elemente mit Details zur Unterkunft. Die untergeordneten Elemente verwenden die folgende 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 werden.
<image>	Optional	Object	Wiederkehrendes Tag, enthält detaillierte Bildinformationen.

Beispiel

Das folgende Beispiel zeigt eine nicht vollständige Hotelliste mit dem Element <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>

Enthält eine Nutzerrezension oder eine redaktionelle Rezension. Du musst nicht alle Rezensionen für einen Eintrag in das Element <listing> aufnehmen. Mit diesem Element sollen ausgewählte Rezensionen aufgenommen werden, die auf die Merkmale oder Qualität dieses Eintrags hinweisen.

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

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

Wichtiger Hinweis: Bevor Rezensionen von Drittanbietern bei Google integriert werden können, musst du eine Inhalte-Lizenzvereinbarung (CLA) abschließen. Lies den Abschnitt Rezensionen von Drittanbietern an Google senden und wende dich an deinen Sales Account Manager, 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 Rezension. Legen Sie dafür einen der folgenden Werte fest: editorial: Eine Rezension einer Website oder einer anderen Prüfstelle. user: Eine Rezension eines Endnutzers.

Untergeordnete Elemente

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

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

Untergeordnetes Element	Erforderlich?	Typ	Beschreibung
<link>	Optional	string	Ein 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, zum Beispiel „Susan von Trapp“. Dies kann auch der Name einer Website oder Publikation sein, auf der die Rezension erscheint, wenn sie nicht als Quelle angegeben ist.
<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 kein HTML 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: das vierstellige Jahr, 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 entspricht dem oben angegebenen <Datum>. Der 7. Juni 2023 wird beispielsweise so geschrieben: <servicedate month="6" day="7" year="2023"/> Rezensionen, für die nicht mindestens Monat und Jahr des <servicedate> angegeben wurden, werden möglicherweise nicht angezeigt. Der Tag ist nicht erforderlich.

<title> ist nur dann ein gültiges untergeordnetes Element von <review>, wenn 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>

Das <attributes>-Tag kann verwendet werden, um die Ausstattung der Unterkunft zu beschreiben und Bewertungen und Rezensionen der Unterkunft zu klassifizieren.

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

Wichtiger Hinweis :Alle Attribute sind optional.

Untergeordnete Elemente

Untergeordnetes Element	Erforderlich?	Beschreibung
<website>	Optional	Die primäre Website für das Hotel. Falls vorhanden, muss er vor dem ersten <client_attr>-Element platziert 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 Platzhalter „attribute_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. Die Verwendung separater IDs ist nützlich, wenn Sie eine Unterkunfts-ID für die Feedinformationen und eine andere Unterkunfts-ID für das Buchungssystem benötigen.	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“. 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 Protokolls Lodging.
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. Sie können aber einen 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 den folgenden Richtlinien entsprechen:

• 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 folgenden Optionen enthält:

  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 Original- und tatsächliche Bilder oder Fotos sein.

Wichtig: Nur Partner, die so konfiguriert sind, dass sie Endnutzern ihre Bilder zeigen, können ihre Bilder auf Google-Plattformen präsentieren. Wenden Sie sich an Ihren Technical Account Manager (TAM), um Ihre Bildeinstellungen zu aktualisieren.

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

Wichtig: 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 deiner Website, auf der sich das betreffende Bild befindet. 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. Sie müssen ein Jahr, einen Monat und einen Tag wie im folgenden Beispiel 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 in Ihr XML-Tag aufnehmen, wie in den folgenden Beispielen gezeigt.

• Sie können Datenwerte in Ihrem Feed mit CDATA-Abschnitten angeben. Wenn Sie CDATA-Abschnitte verwenden, setzen Sie Sonderzeichen nicht mit Escapezeichen zurück.

• 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 verwenden, um diese Sonderzeichen darzustellen. 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 keinen Breiten- und Längengrad für ein Hotel haben, sollten Sie keine leeren Elemente <latitude/> und <longitude/> einfügen.

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

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

• Wenn Sie in Ihrem Feed Kommentare verwenden möchten, umschließen Sie den Kommentar wie im folgenden Beispiel in <!--- und -->-Tags:

  <!-- This is a comment -->
  

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

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