Attribute

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

Die allgemeine XML-Struktur hat ein ähnliches Format wie 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 der Eintrag automatisch deaktiviert.

  • Erforderliche untergeordnete XML-Elemente: id, name, latitude, longitude, address.
  • Erforderliche Attribute: capacity und website.

Weitere Informationen zu den 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 sich der Wert eines Attributs von dem unterscheidet, was im Feed für einen Eintrag für Ferienunterkünfte angegeben ist, wird der Wert für den Eintrag angezeigt. Wenn wir beispielsweise aus den Fotos eines Eintrags erkennen, dass es eine Küche gibt, das Attribut kitchen aber fehlt oder auf No gesetzt ist, wird der Eintrag so behandelt, als hätte er eine Küche. Diese Attribute werden als „abgeleitete Attribute“ bezeichnet und werden nur angezeigt, wenn die Genauigkeit der Inferenz sehr hoch ist.

Werte für den Platzhalter „attribute_name“

Die folgende Tabelle enthält eine Liste gültiger Werte für attribute_name im Element <client_attr name="attribute_name">. Es wird jedoch empfohlen, die zusätzliche attribute_name anzugeben, falls verfügbar.

Werte für attribute_name Erforderlich? Beschreibung Gültige Inhaltswerte
capacity Required Die maximale Anzahl von Gästen, die die Unterkunft beherbergen kann. Dieser Wert sollte gleich oder größer als „Anzahl_der_Schlafzimmer“ sein. Non-negative integer value
website Required Die Website-URL für die Property. Free text
partner_hygiene_link Strongly recommended Link zur externen 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 einen eigenständigen 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–5, 0–10 oder 0–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 Maximal mögliche Bewertung für eine Unterkunft Non-negative integer value
instant_bookable Strongly recommended Ob die Unterkunft beim Bezahlvorgang sofort gebucht werden kann. Alternativ muss auf die Genehmigung gewartet werden. Yes/No/Unknown
description Strongly recommended Freier Text, der die einzigartigen Eigenschaften der Eigenschaft beschreibt Free text
category Strongly recommended Die Art der Immobilie, 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. Zulässige Formate: HHMM, HH:MM oder HH:MM:SS. Verwenden Sie beispielsweise 14:00 statt 14:00 Uhr oder 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. Die Formate HHMM, HH:MM oder HH:MM:SS sind zulässig. Verwenden Sie beispielsweise 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 das Hotel 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
minimum_days_advance_purchase Recommended Mindestanzahl von Tagen im Voraus, über die die Unterkunft gebucht werden kann. Non-negative integer value
minimum_night_stay Recommended Mindestanzahl der Übernachtungen, die ein Gast in der Unterkunft buchen kann. Positive integer (more than zero)
max_night_stay Recommended Maximale Anzahl der Übernachtungen, 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 Immobilie über einen Ofen verfügt. Yes/No/Unknown
parking_type Recommended Die Art der auf dem Grundstück verfügbaren Parkplätze. 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
smoking_free_property Recommended Ob die Unterkunft rauchfrei oder rauchfrei ist. Yes/No/Unknown
special_service_level Recommended Gibt an, ob das Servicelevel des Eintrags etwas Besonderes ist. Beispiele: 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 des WLAN-Internetzugangs der Unterkunft. Free/Paid/None
airport_shuttle Optional Gibt an, ob der Organisator den Transport zum oder vom Flughafen oder zu anderen Terminals anbietet. 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 Gibt an, ob das Frühstück im Preis inbegriffen ist. Yes/No/Unknown
host_description Optional Beschreibung des Hosts für Ferienunterkünfte. Free text
host_language Optional Sprachen, die der Organisator spricht. Eine durch Kommas getrennte Liste von Sprachcodes. Beispiel: de, en.
host_name Optional Name des Hosts der Ferienunterkunft. Free text
host_response_rate Optional Durchschnittliche Antwortrate des Hosts. Non-negative float value, for example, 1, 0.75, 0.5
host_response_time Optional Durchschnittliche Antwortzeit des Hosts. Free text
license_num Optional Die Lizenznummer (Tourist oder Unternehmen) muss für Unterkünfte in bestimmten Regionen der Welt angezeigt werden. Er kann wiederholt werden. Wenn mehrere Lizenzen vorhanden sind, empfehlen wir, die Autorisierung der Lizenz 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 dieser Eintrag befindet. Der Wert muss ein zweistelliger ISO 3116-Ländercode sein. Für die USA ist beispielsweise „US“ und für „Kanada“ CA:
    <country>US</country>
<id> Required string Die eindeutige Kennung für die Unterkunft. Jede Ferienunterkunft muss eine eindeutige ID für Ihre Website haben und sollte nie wiederverwendet werden.
<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 Object or string

Der vollständige Standort der Unterkunft.

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 der Unterkunft angeben. Verwenden Sie untergeordnete <component>-Elemente, um jeden der folgenden Teile der Adresse zu beschreiben:

  • addr1: Die primäre Adresse der Immobilie.
  • addr2: Die sekundäre Adresse, einschließlich der Gebäudenummer, falls erforderlich.
  • addr3: Ein dritter Teil der Adresse.
  • city: Der Name der Stadt, in der sich die Unterkunft befindet.
  • province: Der Name des Bundesstaats, der Region oder der Provinz der Property.
  • postal_code: Postleitzahl der Unterkunft.

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 oder andere Adressen, die nur der Postzustellung dienen, gelten nicht als vollständige physische Adressen.

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="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="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="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="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="smoking_free_property">Yes</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>