Attribute

Auf dieser Seite finden Sie Beschreibungen, Werte und Anforderungen für Attribute und untergeordnete Elemente. Diese Werte gelten nur für Ferienunterkünfte.

Die allgemeine XML-Struktur ähnelt der von Feeds für Hoteleinträge. Weitere Informationen finden Sie in der XML-Referenz für Hotellisten.

Wenn die folgenden erforderlichen Elemente nicht angegeben werden, wird das Unternehmensprofil automatisch deaktiviert:

Weitere Informationen zu erforderlichen untergeordneten XML-Elementen finden Sie unter Untergeordnete XML-Elemente.

Weitere Informationen zu Ferienunterkünften finden Sie unter Spezifische Attribute für Ferienunterkünfte.

Wenn Google schließlich aus anderen Quellen feststellt, dass der Wert eines Attributs sich von dem unterscheidet, der im Feed für ein Ferienunterkunftsangebot angegeben ist, wird der Wert für das Angebot angezeigt. Wenn Google beispielsweise anhand der Fotos eines Eintrags feststellt, dass er eine Küche hat, das Attribut kitchen aber fehlt oder auf No festgelegt ist, geht Google davon aus, dass der Eintrag eine Küche hat. Diese Attribute werden als „abgeleitete Attribute“ bezeichnet und nur angezeigt, wenn die Wahrscheinlichkeit für die Richtigkeit der Ableitung hoch ist.

<review>

Enthält eine Nutzerrezension oder eine redaktionelle Rezension. Sie müssen nicht alle Rezensionen für einen Eintrag in das Element <listing> aufnehmen. Dieses Element ist dazu gedacht, ausgewählte Rezensionen hinzuzufügen, die auf die Funktionen oder Qualität dieses Eintrags hinweisen.

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

+ <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 einen der folgenden Werte dafür fest:
  • editorial: Eine Rezension einer Website oder anderen offiziell prüfberechtigten Stelle.
  • user: Eine Rezension eines Endnutzers.

Untergeordnete Elemente

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

Untergeordnetes Element Erforderlich? Typ Beschreibung
<link> Optional string Ein Link zur Rezension. Fügen Sie in diesem Element „http://“ oder „https://“ ein.
<title> Optional string (Nur redaktionelle Rezensionen) Der Titel der Rezension.
<author> Optional string Der Autor der Rezension, z. B. „Susan von Trapp“. Dies kann auch der Name einer Website oder Publikation sein, in der die Rezension erscheint, falls sie nicht benannt 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 keinen HTML-Code enthalten.
<date month="MM" day="DD" year="YYYY"/> Optional Object (Nur Nutzerrezensionen) Das Datum der Rezension, das Sie mit den folgenden Attributen dieses Elements angeben:
  • day: Der Tag des Monats. Zum Beispiel: „7“.
  • month: Der Monat, wobei 1 = Januar und 12 = Dezember ist.
  • 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 ist identisch zum <date>-Format.

Der 7. Juni 2023 wird beispielsweise so geschrieben:

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

Rezensionen, für die nicht mindestens der Monat und das Jahr des <servicedate> angegeben wurden, werden möglicherweise nicht angezeigt. Der Tag ist nicht erforderlich.

Beispiel

Das folgende Beispiel zeigt eine nicht vollstä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>

Werte für den Platzhalter attribute_name

In der folgenden Tabelle finden Sie eine Liste der gültigen Werte für attribute_name im Element <client_attr name="attribute_name">. Es wird jedoch empfohlen, dass Sie Ihre zusätzlichen attribute_name angeben, sofern verfügbar.

Werte für attribute_name Erforderlich? Beschreibung Gültige Inhaltswerte
capacity Required Maximale Anzahl von Gästen, die die Unterkunft beherbergen kann. Dieser Wert sollte gleich oder größer als „number_of_bedrooms“ sein. Non-negative integer value
website Required Die Website-URL für die Unterkunft. Free text
partner_hygiene_link Strongly recommended Link zu externer Partnerwebsite mit weiteren Informationen zu den Hygienedetails des Eintrags. Free text (the site's URL)
number_of_bathrooms Strongly recommended Anzahl der Badezimmer. Non-negative float value, for example, 1, 1.5, 2
number_of_bedrooms Strongly recommended Anzahl der Schlafzimmer. Non-negative integer value
number_of_beds Strongly recommended Anzahl der Betten in allen Zimmern. Non-negative integer value
self_checkin_checkout Recommended Gibt an, ob die Unterkunft Selfservice für Check-in und Check-out zulässt. Yes/No/Unknown
rating Strongly recommended 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. Non-negative float value
rating_num Strongly recommended Anzahl der Bewertungen, die die Unterkunft hat. Non-negative integer value
rating_scale Strongly recommended Die höchstmögliche Bewertung für eine Unterkunft. Wenn die rating_scale (Bewertungsskala) beispielsweise 5 ist, sollte die Eigenschaft „rating“ (Bewertung) 3 oder 4 sein.

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

Non-negative integer value
instant_bookable Strongly recommended Ob die Unterkunft beim Zahlungsvorgang sofort gebucht werden kann. Alternativ muss auf eine Bestätigung gewartet werden. Yes/No/Unknown
description Strongly recommended Freiformtext, in dem die besonderen Eigenschaften der Unterkunft beschrieben werden Free text
category Strongly recommended Die Art der Unterkunft, z. B. Villa, Bungalow, Hütte oder Apartment Free text
ac Recommended Ob die Unterkunft über eine Klimaanlage verfügt. Yes/No/Unknown
beach_access Recommended Ob die Unterkunft Zugang zu einem öffentlichen Strand in der Nähe der Unterkunft hat. Yes/No/Unknown
check_in_time Recommended Die genaue Tageszeit für den Check-in in der Unterkunft. Die Formate HHMM, HH:MM oder HH:MM:SS sind zulässig. Verwenden Sie beispielsweise 14:00 anstelle von 14:00 Uhr. Alle anderen Formate werden nicht geparst oder angezeigt. Time
check_out_time Recommended Die genaue Tageszeit für den Check-out aus der Unterkunft. Es werden die Formate HHMM, HH:MM oder HH:MM:SS akzeptiert. Verwenden Sie z. B. 11:00 statt 11am oder 11:00am. Alle anderen Formate werden nicht geparst oder angezeigt. Time
child_friendly Recommended Ob die Unterkunft für Kinder geeignet ist. Yes/No/Unknown
crib Recommended Ob die Unterkunft ein Kinderbett bereitstellt. Yes/No/Unknown
elevator Recommended Ob die Unterkunft über einen Fahrstuhl verfügt. Yes/No/Unknown
gym_fitness_equipment Recommended Ob die Unterkunft einen Fitnessraum oder Fitnessgeräte hat. Yes/No/Unknown
heating Recommended Ob die Unterkunft eine Heizung hat. Yes/No/Unknown
hot_tub Recommended Ob die Unterkunft einen Whirlpool hat. Yes/No/Unknown
ironing_board Recommended Ob die Unterkunft Bügelbretter hat. Yes/No/Unknown
kitchen Recommended Ob die Unterkunft eine Küche hat. Yes/No/Unknown
microwave Recommended Ob in der Unterkunft eine Mikrowelle verfügbar ist. Yes/No/Unknown
min_days_advance_purchase Recommended Anzahl der Tage, die die Unterkunft mindestens im Voraus gebucht werden muss. Non-negative integer value
min_night_stay Recommended Mindestanzahl der Übernachtungen, für die ein Gast die Unterkunft buchen kann. Positive integer (more than zero)
max_night_stay Recommended Maximale Anzahl von Übernachtungen, für die ein Gast die Unterkunft buchen kann. Positive integer (more than zero)
outdoor_grill Recommended Ob die Unterkunft einen Grill hat. Yes/No/Unknown
oven_stove Recommended Ob die Unterkunft einen Herd hat. Yes/No/Unknown
parking_type Recommended Art der Parkmöglichkeiten auf dem Grundstück. Free/Paid/None
patio Recommended Ob die Unterkunft eine Terrasse hat. Yes/No/Unknown
pets_allowed Recommended In einigen oder allen Zimmern können Haustiere (Hunde oder Katzen, die keine Assistenztiere sind) mitgebracht werden. Yes/No/Unknown
pool_type Recommended Art des Pools (Poolzugang), den die Unterkunft hat. Indoors, Outdoors, Indoors/Outdoors, None
room_type Recommended Die Art des Zimmers. ENTIRE_PLACE ist der einzige unterstützte Wert. ENTIRE_PLACE
smoking_free_property Recommended Ob die Unterkunft rauchfrei ist oder Rauchen nicht gestattet ist. Yes/No/Unknown
special_service_level Recommended Gibt an, ob der Servicelevel des Eintrags in irgendeiner Weise besonders ist. Beispiel: verified, luxury, premium Yes/No/Unknown
square_footage Recommended Die Fläche des Grundstücks in Quadratfuß. Non-negative float value
square_meters Recommended Die Fläche des Grundstücks in Quadratmetern. Non-negative float
tv Recommended Ob die Unterkunft einen Fernseher hat. Yes/No/Unknown
washer_dryer Recommended Ob in der Unterkunft Waschmaschinen vorhanden sind. Yes/No/Unknown
wheelchair_accessible Recommended Ob die Unterkunft für Rollstuhlfahrer zugänglich ist. Yes/No/Unknown
internet_type Recommended Art der WLAN-Verbindung, die von der Unterkunft bereitgestellt wird. Free/Paid/None
airport_shuttle Optional Gibt an, ob der Anbieter den Transport zum oder vom Flughafen oder zu anderen Terminals organisiert. Yes/No/Unknown
balcony Optional Ob die Unterkunft über einen Balkon verfügt. Yes/No/Unknown
fire_place Optional Ob die Unterkunft über einen Kamin verfügt. Yes/No/Unknown
free_breakfast Optional Ob das Frühstück im Preis inbegriffen ist. Yes/No/Unknown
host_description Optional Beschreibung des Gastgebers der Ferienunterkunft. Free text
host_language Optional Sprachen, die der Organisator spricht. Eine durch Kommas getrennte Liste mit Sprachcodes, z. B. de, en
host_name Optional Name des Vermieters der Ferienunterkunft. Free text
host_response_rate Optional Durchschnittliche Antwortrate des Gastgebers. Non-negative float value, for example, 1, 0.75, 0.5
host_response_time Optional Durchschnittliche Reaktionszeit des Gastgebers. Free text
license_num Optional Die Lizenznummer (touristisch oder geschäftlich) muss für Unterkünfte in bestimmten Regionen der Welt angezeigt werden. Sie kann wiederholt werden. Wenn mehrere Lizenzen vorhanden sind, empfehlen wir, die lizenzvergebende Stelle als Kontext hinzuzufügen, z. B. „Paris: 123456ABC“. Free text
number_of_half_bathrooms Optional Anzahl der halben Badezimmer. Non-negative integer value
number_of_living_rooms Optional Anzahl der Wohnzimmer. Non-negative integer value
private_beach_access Optional Ob die Unterkunft einen eigenen Zugang zu einem nicht öffentlichen Strand hat. Yes/No/Unknown
refund_policy Optional Erstattungsrichtlinien für die Unterkunft. Free text

Untergeordnete XML-Elemente

Die folgenden untergeordneten XML-Elemente sind erforderlich:

Untergeordnetes Element Erforderlich? Typ Beschreibung
<country> Strongly recommended string Das Land, in dem sich der Eintrag befindet. Der Wert muss ein zweistelliger Ländercode gemäß ISO 3116 sein, z. B. US für die USA und CA für Kanada: 
    <country>US</country>
<id> Required string Die eindeutige Kennung für die Unterkunft. Beachten Sie, dass jedes Ferienobjekt eine eindeutige ID für Ihre Website haben muss und dass die ID nie wiederverwendet werden sollte.
<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.
<name> Required string Der Name der Unterkunft. Maximal 300 Zeichen.
<address> Required string or Object

Der vollständige Standort der Unterkunft als String. Die Adresse muss einen Straßennamen und eine Hausnummer enthalten. Wenn keine vorhanden ist, sollte die Adresse einen Pluscode enthalten. Apartment- oder Büronummern müssen gegebenenfalls ebenfalls angegeben werden.

Alternativ können Sie eine „zusammengesetzte“ Adresse angeben. Verwenden Sie untergeordnete Elemente des Typs <component>, um die jeweiligen Abschnitte der Adresse zu beschreiben:

  • addr1: Die primäre Adresse.
  • addr2: Falls erforderlich, die sekundäre Adresse, einschließlich der Wohnungsnummer.
  • city: Die Stadt.
  • province: Falls erforderlich, das Bundesland, die Region oder die Provinz.
  • postal_code: Die Postleitzahl.
  • country: Das Land.

Beachten Sie, dass Postfachadressen und andere Adressen, die nur der Postzustellung dienen, nicht als gültige Adressen gelten.

Hier sind Beispiele für eine vollständige Adresse:

<address>6 Acacia Ave Apt. 2, Nottingham NG8 6FT, UK/address>
 
<address>
  <component name="addr1">6 Acacia Ave</component>
  <component name="addr2">Apt. 2</component>
  <component name="city">Nottingham </component>
  <component name="postal_code">NG8 6FT</component>
  <component name="country">UK</component>
</address>

Hier sind Beispiele für eine vollständige Adresse mit einem Plus Code:

<address>XQHM+7VF Nottingham NG8 6FT, UK/address>
 
<address>
  <component name="addr1">XQHM+7VF</component>
  <component name="city">Nottingham </component>
  <component name="postal_code">NG8 6FT</component>
  <component name="country">UK</component>
</address>

Vermeiden Sie Folgendes:

  • Redundante Informationen: Geben Sie keine überflüssigen Informationen an und wiederholen Sie keine Adressbestandteile.
  • Fehlende Adresse: Adressen müssen einen Straßennamen und eine Hausnummer enthalten.

Beispiel für einen Eintrag für Ferienunterkünfte

<?xml version="1.0" encoding="UTF-8"?>
<listings>
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>Apartment Name</name>
    <address format="simple">
      <component name="addr1">18733 Clark Way</component>
      <component name="addr2">#C10</component>
      <component name="city">Mountain View</component>
      <component name="postal_code">94043</component>
      <component name="province">California</component>
    </address>
    <country>US</country>
    <latitude>37.4182515</latitude>
    <longitude>-122.0742354</longitude>
    <phone type="main">12345678</phone>
    <category>vacation_villa</category>
    <date day="21" month="12" year="2017"/>
    <content>
      <text type="description">
        <link>https://list_url</link>
        <title>Description Title</title>
        <body>Description Body</body>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE</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="2017"/>
        <servicedate day="16" month="6" year="2017"/>
      </review>
      <attributes>
        <website>https://hotel.example.com/123456</website>
        <client_attr name="capacity">7</client_attr>
        <client_attr name="cleaning_disinfection">Yes</client_attr>
        <client_attr name="min_days_between_stays">3</client_attr>
        <client_attr name="enhanced_cleaning_practices">Yes</client_attr>
        <client_attr name="partner_hygiene_link">http://www.example.com/hygiene/</client_attr>
        <client_attr name="number_of_bathrooms">2</client_attr>
        <client_attr name="number_of_bedrooms">3</client_attr>
        <client_attr name="number_of_beds">4</client_attr>
        <client_attr name="self_checkin_checkout">Yes</client_attr>
        <client_attr name="rating">4.8</client_attr>
        <client_attr name="rating_num">5373</client_attr>
        <client_attr name="rating_scale">5</client_attr>
        <client_attr name="ac">Yes</client_attr>
        <client_attr name="airport_shuttle">Yes</client_attr>
        <client_attr name="balcony">No</client_attr>
        <client_attr name="beach_access">Yes</client_attr>
        <client_attr name="check_in_time">15:00</client_attr>
        <client_attr name="check_out_time">11:00</client_attr>
        <client_attr name="child_friendly">Yes</client_attr>
        <client_attr name="crib">Unknown</client_attr>
        <client_attr name="elevator">Yes</client_attr>
        <client_attr name="fire_place">Unknown</client_attr>
        <client_attr name="free_breakfast">Yes</client_attr>
        <client_attr name="gym_fitness_equipment">Yes</client_attr>
        <client_attr name="heating">Yes</client_attr>
        <client_attr name="host_description">A short description about the host and their interests</client_attr>
        <client_attr name="host_name">The name of the host</client_attr>
        <client_attr name="host_language">en, da, el</client_attr>
        <client_attr name="host_response_rate">0.75</client_attr>
        <client_attr name="host_response_time">1 hour</client_attr>
        <client_attr name="hot_tub">Yes</client_attr>
        <client_attr name="instant_bookable">Yes</client_attr>
        <client_attr name="internet_type">Free</client_attr>
        <client_attr name="ironing_board">No</client_attr>
        <client_attr name="kitchen">Yes</client_attr>
        <client_attr name="license_num">Free text. If multiple licenses exist, we suggest adding authority of the licence as context</client_attr>
        <client_attr name="license_num">Paris: 123456ABC</client_attr>
        <client_attr name="microwave">Yes</client_attr>
        <client_attr name="max_night_stay">7</client_attr>
        <client_attr name="min_days_advance_purchase">2</client_attr>
        <client_attr name="min_night_stay">3</client_attr>
        <client_attr name="number_of_living_rooms">1</client_attr>
        <client_attr name="outdoor_grill">No</client_attr>
        <client_attr name="oven_stove">Yes</client_attr>
        <client_attr name="parking_type">Free</client_attr>
        <client_attr name="patio">Unknown</client_attr>
        <client_attr name="pets_allowed">Yes</client_attr>
        <client_attr name="pool_type">Indoors</client_attr>
        <client_attr name="private_beach_access">Unknown</client_attr>
        <client_attr name="room_type">ENTIRE_PLACE</client_attr>
        <client_attr name="refund_policy">The refund policy for the property</client_attr>
        <client_attr name="smoking_free_property">Yes</client_attr>
        <client_attr name="special_service_level">No</client_attr>
        <client_attr name="square_footage">1200</client_attr>
        <client_attr name="tv">Yes</client_attr>
        <client_attr name="washer_dryer">Yes</client_attr>
        <client_attr name="wheelchair_accessible">Yes</client_attr>
      </attributes>
    </content>
  </listing>
</listings>