XML-Referenz für Hotellisten

Eine Hotelliste enthält eine oder mehrere XML-Dateien, in denen alle Hotels aufgelistet sind, für die Sie Preisinformationen bereitstellen. 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 der ersten Implementierung und fügen dann im Rahme der regelmäßigen Pflege der Daten Hotels hinzu oder entfernen diese.

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 einfügen.

Nachdem Sie eine Hotelliste erstellt haben, können Sie sie manuell über https://support.google.com/hotelprices/auf Google hochladen oder auf Ihrem Server hosten.

Datenprobleme finden und beheben

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

Anforderungen an Listeneinträge

Um sich für Google Hotelanzeigen zu qualifizieren, müssen Unterkünfte in Ihrer Hotelliste folgende Eigenschaften haben:

  • 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

Nicht zulässig sind beispielsweise Kreuzfahrtschiffe und Apartments, da diese in der Regel die Listing requirements-Kriterien nicht erfüllen.

Campinghütten und andere Campingeinrichtungen mit festen Wänden, Sanitärinstallationen und Klimaanlagen (einschließlich Holzöfen oder Propanheizungen) sind zulässig. Nicht zulässige 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>.

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. Geben Sie als Wert dieses Elements einen aus zwei Buchstaben bestehenden Sprachcode an. Zum Beispiel en für Englisch.
<datum> Optional enum Dieses Element gibt das geodätische Bezugssystem oder Referenzmodell für die im Feed angegebenen Breiten- und Längengradkoordinaten an. Wenn kein Datumswert angegeben ist, ist der Standardwert für dieses Element WGS84, der von den meisten modernen GPS-Geräten verwendet wird. Das Tokio-Datum 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 das jeweilige Hotel im Feed beschreiben. Beachten Sie, dass jedes Hotel in der Liste eine eindeutige Kennung für Ihre Website haben muss und dass die Kennung nie wiederverwendet werden sollte.

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>

Freiformadresse

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

<?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 nicht vollstä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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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 <listing>-Element ist in der XML-Hierarchie des Hotellistenfeeds an der folgenden Stelle vorhanden:

+ <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 gesamte Website immer eindeutig sein. Verwenden Sie Kennungen NICHT noch einmal, da dies Probleme beim Beheben von Problemen mit der Unterkunftszuordnung verursachen 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 sowie die Postleitzahl des Hotels angeben. Verwenden Sie untergeordnete Elemente des Typs <component>, um die jeweiligen Abschnitte der Adresse zu beschreiben:

  • addr1: Die primäre Adresse des Hotels.
  • addr2: Die sekundäre Adresse, falls erforderlich.
  • addr3: Einen dritten Teil der Adresse, falls erforderlich.
  • city: Den Namen der Stadt, in der sich das Hotel befindet.
  • province: Den Namen des Bundesstaats, der Region oder der Provinz, in der sich das Hotel befindet.
  • 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 Freiformadresse angeben. Dies wird jedoch nicht empfohlen. Beispiel:

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

Beachten Sie, dass Postfachadressen und andere Adressen, die nur der Postzustellung dienen, nicht als gültige Adressen gelten.
<country> Required string Das Land, in dem sich der Eintrag befindet. Der Wert muss ein zweistelliger 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 In Metern gesendete Genauigkeit des Standorts der Unterkunft, wenn Breiten- und Längengrad des Attributs verschleiert werden. Null (0) bedeutet, dass es keine Verschleierung gibt und dass 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 der Eintrag eine Unternehmensfiliale oder -niederlassung ist, geben Sie die Telefonnummer des Niederlassungsstandortes an (nicht die Telefonnummer des Hauptsitzes).

Das Attribut type kann einen der folgenden Werte haben:

  • fax: Faxnummer.
  • main: Haupttelefonnummer.
  • mobile: Mobiltelefonnummer.
  • tdd: Telefonnummer für Telekommunikationsgerät für Gehörlose.
  • 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 sollten mindestens einen Typ main angeben.
<category> Optional string Die Art der Unterkunft, z. B. ein Hotel. Partner können alle internen Kategorien verwenden, mit denen sie ihre Unterkunft beschreiben können, 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 Breitengrad/Längengrad erforderlich. Wir empfehlen, beide anzugeben.

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>

Freiformadresse

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

<?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 nicht vollstä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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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, Ausstattung und weitere Details. Das <content>-Element ist optional. Innerhalb von <content> sind alle untergeordneten Elemente optional.

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

+ <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 attributes: -->
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="alternate_hotel_id">alternate_hotel_id</client_attr>
        <client_attr name="hotel_brand">hotel_brand</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. Fügen Sie in diesem Element „http://“ oder
    „https://“ ein (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. Dieses Element ist dazu gedacht, ausgewählte Rezensionen aufzunehmen, die die Merkmale oder Qualität dieses Eintrags darstellen.

Wichtiger Hinweis: <review> sollte nur für Ferienunterkunftskonten gesendet werden. Weitere Informationen erhalten Sie von Ihrem Technical Account Manager (TAM).
<attributes> Optional Object

Enthält 0 oder mehr untergeordnete <client_attr>-Elemente, die Details zur Unterkunft enthalten. Untergeordnete Elemente verwenden folgende Syntax:

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

Eine Liste und eine Beschreibung von untergeordneten Elementen finden Sie unter <attributes>.

Alle <client_attr>-Elemente sind optional.

Wenn es ein untergeordnetes <website>-Element gibt, muss es vor jedem <client_attr>-Element platziert 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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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 <attributes>-Tag können Sie die Ausstattung der Unterkunft beschreiben und Bewertungen der Unterkunft klassifizieren.

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

Untergeordnete Elemente

Untergeordnetes Element Erforderlich? Beschreibung
<website> Optional Die primäre Website des Hotels. Sofern vorhanden, muss sie 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 mithilfe des 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. Separate Kennungen sind nützlich, wenn Sie eine Unterkunftskennung für Ihre Feedinformationen und eine weitere Unterkunftskennung für Ihr Buchungssystem benötigen. Beliebiger Stringwert
Verworfen:Alle benutzerdefinierten Attribute vom Typ „String“. Diese werden Nutzern nicht angezeigt.

Wichtig:Wenn Sie CUSTOM-Variablen verwenden möchten, wenden Sie sich an Ihren Technical Account Manager (TAM).

 Beliebiger Stringwert
hotel_brand Die Kette, zu der dieses Hotel gehört. Beispiel: „Marriott“ oder „Hilton“. Sie wird den Nutzern nicht angezeigt, kann aber zum Gruppieren von Hotels verwendet werden. Beliebiger Stringwert
lodging Codierte Darstellung aller Felder, die im Lodging-Proto verfügbar sind. Base64-codierter String des codierten Lodging-Protokolls
num_reviews Anzahl der Rezensionen des Eintrags.

Wichtiger Hinweis: „num_reviews“ sollte nur für Feeds für Ferienunterkünfte gesendet werden.

 Beliebige nicht negative Ganzzahl.
rating Eine Gleitkommazahl, die die Gesamtbewertung der Unterkunft darstellt. Diese Zahl liegt normalerweise zwischen 0 und 5, 0 und 10 oder 0 und 100. Sie können aber auch einen beliebigen Bereich verwenden, der Ihr Bewertungssystem darstellt. Wenn die rating_scale 5 ist, sollte die Eigenschaftsbewertung beispielsweise 3 oder 4 sein.

Hinweis: Wenn nicht angegeben, ist die Standardeinstellung für „rating_scale“ 0–10.

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> is allowed in Vacation Rentals only -->
            + <review>
            + <attributes>
            + <image>

Bilder dienen zur Darstellung der Unterkunft in der Eintrags-ID. 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 diese eine der beiden folgenden Optionen enthält:

    1. Der Googlebot-Crawler kann den Inhalt und die Bilder auf Ihrer Website crawlen.

      • User-agent: Googlebot
      • Allow: /

    2. Der Googlebot-Bild-Crawler kann die Bilder auf Ihrer Website 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.

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

Das Bild muss einer der folgenden Typen sein:
url Required Text Die URL des Bildes in Originalgröße. Mit dem Attribut url geben Sie das Bild an, 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

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, auf der sich das relevante 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

Das 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 nicht vollstä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 wie in den folgenden Beispielen gezeigt das Attribut encoding in Ihr XML-Tag einfügen.

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

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

    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 den Breiten- und Längengrad für ein Hotel nicht vorliegen haben, sollten Sie keine leeren <latitude/>- und <longitude/>-Elemente angeben.

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

  • Wenn Sie Ihren Feed vor dem Hochladen validieren möchten, können Sie den lokalen Feed-XSD http://www.gstatic.com/localfeed/local_feed.xsd verwenden.

  • Wenn Sie in Ihrem Feed Kommentare verwenden möchten, müssen Sie den Kommentar wie im folgenden Beispiel in die Tags <!-- und --> einfügen:

    <!-- This is a comment -->