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:
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 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:
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 Sie müssen mindestens die Adresse, die Stadt, das Bundesland oder die Region und die Postleitzahl des Hotels angeben. Verwenden Sie untergeordnete
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
Beispiel: <!-- Singapore (country code +65) --> <phone type="main">+65 6722-2323</phone> <!-- U.S. (country code +1) --> <phone type="fax">+1 408-555-1111</phone> Sie müssen mindestens einen |
<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 |
Optional | Object | Die mit dem Eintrag des Anbieters verknüpfte Webseite. Diese weist die folgenden untergeordneten Elemente auf:
Hinweis: Diese Elemente müssen in der oben angegebenen Reihenfolge angezeigt werden. |
<review |
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 |
<attributes> | Optional | Object | Enthält 0 oder mehr untergeordnete <client_attr name="attribute_name">attribute_value<client_attr> Eine Liste und Beschreibung untergeordneter Elemente finden Sie unter Alle Wenn ein untergeordnetes |
<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>
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:
|
Untergeordnete Elemente
Das <review>
-Element hat die folgenden untergeordneten Elemente:
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:
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>
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:
Erlaubt dem Googlebot-Crawler, den Content und die Bilder auf Ihrer Website zu crawlen.
- User-agent: Googlebot
- Allow: /
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.
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
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 SieCDATA
-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 (<) < < 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"/>