Attributs

Cette page décrit les attributs et les éléments enfants, ainsi que leurs valeurs et leurs exigences. Ces valeurs ne s'appliquent qu'aux établissements de location de vacances.

La structure XML générale est semblable à celle des flux de fiches d'hôtels. Consultez la documentation de référence pour les listes d'hôtels au format XML.

Si vous n'incluez pas les éléments obligatoires suivants, votre fiche sera automatiquement désactivée :

  • Éléments enfants XML requis : id, name, latitude, longitude, address.
  • Attributs obligatoires : capacity et website. Consultez les liens directs pour les locations de vacances dans votre flux de fiches. Cela permet aux utilisateurs de visiter le site Web de l'établissement.

Pour en savoir plus sur les éléments enfants XML requis, consultez Éléments enfants XML.

Pour en savoir plus sur les locations de vacances, consultez Attributs spécifiques aux locations de vacances.

Enfin, lorsque Google détermine à partir d'autres sources que la valeur d'un attribut est différente de celle spécifiée dans le flux pour une fiche de location de vacances, Google affiche la valeur pour la fiche. Par exemple, si Google détermine à partir des photos d'une fiche qu'elle dispose d'une cuisine, mais que l'attribut kitchen est absent ou défini sur No, Google considère que la fiche dispose d'une cuisine. Ces attributs sont appelés "attributs inférés". Ils ne s'affichent que lorsque la précision de l'inférence est élevée.

<review>

Contient un avis d'utilisateur ou de journaliste. Il n'est pas nécessaire d'inclure tous les avis sur une fiche dans votre élément <listing>. Cet élément est destiné à inclure des avis choisis qui reflètent les caractéristiques ou la qualité de l'établissement.

L'élément <review> apparaît à l'emplacement suivant dans la hiérarchie XML du flux Hotel List Feed :

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

Syntaxe

L'élément <review> utilise la syntaxe suivante :

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

Attributs

L'élément <review> comporte les attributs suivants :

Attribut nécessaire Description
type Required Type d'avis. Définissez l'une des valeurs suivantes :
  • editorial : avis publié par un site Web ou une autre autorité de formulation d'avis.
  • user : avis d'un utilisateur final.

Éléments enfants

L'élément <review> comporte les éléments enfants suivants :

Élément enfant Obligatoire ? Type Description
<link> Optional string Lien vers l'avis. Incluez "http://" ou "https://" dans cet élément.
<title> Optional string (Avis de journalistes uniquement) Titre de l'avis.
<author> Optional string Auteur de l'avis, par exemple : "Susan von Trapp". Il peut également s'agir du nom d'un site Web ou d'une publication où apparaît l'avis s'il n'est pas signé.
<rating> Optional string Nombre à virgule flottante compris entre 0 et 10 (inclus) représentant la note de l'avis. Par exemple, "8.9".
<body> Optional string Texte de l'avis. Cet élément ne doit pas contenir de code HTML.
<date month="MM" day="DD" year="YYYY"/> Optional Object (Avis des utilisateurs uniquement) Date de l'avis, que vous spécifiez avec les attributs suivants de cet élément :
  • day : jour du mois, par exemple : "7".
  • month : mois, (1 = janvier, …, 12 = décembre).
  • year : année à quatre chiffres, par exemple "2023".

Par exemple, le 7 juin 2023 est écrit comme suit :

<date month="6" day="7" year="2023"/>
<servicedate month="MM" day="DD" year="YYYY"/> Optional Object (Avis des utilisateurs uniquement) Date à laquelle le contributeur a consulté la fiche. Le format est identique à <date>.

Par exemple, le 7 juin 2023 est écrit comme suit :

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

Les avis n'incluant pas au moins le mois et l'année de <servicedate> ne sont pas affichés. Le jour n'est pas obligatoire.

Exemple

L'exemple suivant présente une liste partielle d'hôtels avec une fiche qui contient un avis de journaliste et un avis utilisateur :

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

Valeurs de l'espace réservé attribute_name

Le tableau suivant fournit la liste des valeurs valides pour attribute_name dans l'élément <client_attr name="attribute_name">. Toutefois, nous vous recommandons de fournir vos valeurs attribute_name supplémentaires si vous en avez.

Valeurs pour attribute_name Obligatoire ? Description Valeurs de contenu valides
capacity Required Nombre maximal de personnes que l'établissement peut accueillir. Cette valeur doit être supérieure ou égale à "number_of_bedrooms". Non-negative integer value
website Required URL du site Web de la propriété. Free text
partner_hygiene_link Strongly recommended Lien vers le site externe du partenaire fournissant plus d'informations sur l'hygiène dans l'établissement. Free text (the site's URL)
number_of_bathrooms Strongly recommended Nombre de salles de bain. Non-negative float value, for example, 1, 1.5, 2
number_of_bedrooms Strongly recommended Nombre de chambres. Non-negative integer value
number_of_beds Strongly recommended Nombre de lits dans toutes les chambres. Non-negative integer value
self_checkin_checkout Recommended Indique si l'établissement autorise l'arrivée et le départ en autonomie. Yes/No/Unknown
rating Strongly recommended Nombre à virgule flottante représentant la note globale de l'établissement. Ce nombre est généralement compris entre 0 et 5, 0 et 10, ou 0 et 100, mais vous pouvez utiliser n'importe quelle plage représentant votre système de notation. Non-negative float value
rating_num Strongly recommended Nombre de notes de l'établissement. Non-negative integer value
rating_scale Strongly recommended Note maximale possible pour un établissement. Par exemple, la note de l'établissement doit être de 3 ou 4 pour une échelle de notation de 5.

Remarque : Si aucune échelle de notation n'est spécifiée, la valeur par défaut est 0-10.

Non-negative integer value
instant_bookable Strongly recommended Indique si l'établissement peut être réservé instantanément via le processus de règlement. L'alternative est l'attente d'approbation. Yes/No/Unknown
description Strongly recommended Texte libre décrivant les qualités uniques de la propriété Free text
category Strongly recommended Type d'établissement, tel qu'une villa, un bungalow, un chalet ou un appartement Free text
ac Recommended Indique si l'établissement est climatisé. Yes/No/Unknown
beach_access Recommended Indique si l'établissement est proche d'une plage publique. Yes/No/Unknown
check_in_time Recommended Heure précise d'arrivée dans l'établissement. Format HHMM, HH:MM ou HH:MM:SS accepté. Par exemple, utilisez 14:00 au lieu de 14h ou 14h00. Tous les autres formats ne seront pas analysés ni affichés. Time
check_out_time Recommended Heure précise de départ de l'établissement. Format HHMM, HH:MM ou HH:MM:SS accepté. Par exemple, utilisez 11:00 au lieu de 11h ou 11h00. Tous les autres formats ne seront pas analysés ni affichés. Time
child_friendly Recommended Indique si l'établissement est adapté aux enfants. Yes/No/Unknown
crib Recommended Indique si l'établissement fournit un berceau. Yes/No/Unknown
elevator Recommended Indique si l'établissement dispose d'un ascenseur. Yes/No/Unknown
gym_fitness_equipment Recommended Indique si l'établissement dispose d'une salle de sport ou d'équipements de fitness. Yes/No/Unknown
heating Recommended Indique si l'établissement dispose du chauffage. Yes/No/Unknown
hot_tub Recommended Indique si l'établissement dispose d'un bain à remous. Yes/No/Unknown
ironing_board Recommended Indique si l'établissement propose des planches à repasser. Yes/No/Unknown
kitchen Recommended Indique si l'établissement est équipé d'une cuisine. Yes/No/Unknown
microwave Recommended Indique si un four à micro-ondes est disponible dans l'établissement. Yes/No/Unknown
min_days_advance_purchase Recommended Nombre minimal de jours avant la date d'arrivée où l'établissement peut être réservé. Non-negative integer value
min_night_stay Recommended Nombre minimal de nuits pendant lesquelles un client peut réserver l'établissement. Positive integer (more than zero)
max_night_stay Recommended Nombre maximal de nuits pendant lesquelles un client peut réserver l'établissement. Positive integer (more than zero)
outdoor_grill Recommended Indique si l'établissement est doté d'un barbecue. Yes/No/Unknown
oven_stove Recommended Indique si l'établissement est équipé d'une cuisinière. Yes/No/Unknown
parking_type Recommended Type de parking disponible dans l'établissement. Free/Paid/None
patio Recommended Indique si l'établissement possède un patio. Yes/No/Unknown
pets_allowed Recommended Une partie ou l'intégralité des chambres accueille les animaux de compagnie des clients (chiens ou chats hors animaux d'assistance). Yes/No/Unknown
pool_type Recommended Type de piscine (accès à la piscine) dont dispose l'établissement. Indoors, Outdoors, Indoors/Outdoors, None
room_type Recommended Type de salle. ENTIRE_PLACE est la seule valeur acceptée. ENTIRE_PLACE
smoking_free_property Recommended Indique si l'établissement est non-fumeur ou si la cigarette y est interdite. Yes/No/Unknown
special_service_level Recommended Indique si le niveau de service de la fiche est spécial. Par exemple, verified, luxury, premium Yes/No/Unknown
square_footage Recommended Superficie de l'établissement en mètres carrés. Non-negative float value
square_meters Recommended Superficie de l'établissement en mètres carrés. Non-negative float
tv Recommended Indique si l'établissement est équipé d'une télévision. Yes/No/Unknown
washer_dryer Recommended Indique si l'établissement est équipé d'appareils de buanderie. Yes/No/Unknown
wheelchair_accessible Recommended Indique si l'établissement est accessible en fauteuil roulant. Yes/No/Unknown
internet_type Recommended Type d'accès Internet Wi-Fi fourni par l'établissement. Free/Paid/None
airport_shuttle Optional Indique si l'hôte assure le transport depuis ou vers l'aéroport ou d'autres terminaux. Yes/No/Unknown
balcony Optional Indique si l'établissement possède un balcon. Yes/No/Unknown
fire_place Optional Indique si l'établissement est doté d'une cheminée. Yes/No/Unknown
free_breakfast Optional Indique si l'établissement propose un petit-déjeuner gratuit. Yes/No/Unknown
host_description Optional Description de l'hôte de la location de vacances. Free text
host_language Optional Langues parlées par l'hôte. Liste des codes de langue séparés par une virgule (par exemple : de, en)
host_name Optional Nom de l'hôte de la location de vacances. Free text
host_response_rate Optional Taux de réponse moyen de l'hôte. Non-negative float value, for example, 1, 0.75, 0.5
host_response_time Optional Temps de réponse moyen de l'hôte. Free text
license_num Optional Numéro de licence (tourisme ou affaires) qui doit être indiqué pour les établissements de certaines régions du monde. Il peut être répété et, si plusieurs licences existent, nous vous suggérons d'ajouter la portée de la licence en tant que contexte (par exemple : "Paris : 123456ABC"). Free text
number_of_half_bathrooms Optional Nombre de demi-salles de bain. Non-negative integer value
number_of_living_rooms Optional Nombre de salons. Non-negative integer value
private_beach_access Optional Indique si l'établissement dispose d'un accès dédié à une plage non publique. Yes/No/Unknown
refund_policy Optional Conditions de remboursement pour l'établissement. Free text

Éléments enfants XML

Les éléments enfants XML suivants sont obligatoires :

Élément enfant Obligatoire ? Type Description
<country> Strongly recommended string Pays dans lequel se trouve l'établissement. La valeur doit être un code pays à deux lettres ISO 3116. Par exemple, les États-Unis sont représentés par US et le Canada par CA : 
    <country>US</country>
<id> Required string Identifiant unique de l'établissement. Notez que chaque location de vacances doit posséder un ID propre à votre site, et que cet ID ne doit jamais être réutilisé.
<latitude> Required float Latitude de l'emplacement de l'hôtel. Exemple : 
    <latitude>37.423738</latitude>

Cette valeur peut être générée avec des outils de géocodage tels que l'API Google Maps.
<longitude> Required float Longitude de l'emplacement de l'hôtel. Exemple : 
    <longitude>-122.090101</longitude>

Cette valeur peut être générée avec des outils de géocodage tels que l'API Google Maps.
<name> Required string Nom de la propriété. 300 caractères maximum.
<address> Required string or Object

Emplacement physique complet de l'établissement sous forme de chaîne. L'adresse doit inclure un nom et un numéro de rue. Si aucune n'existe, l'adresse doit inclure un Plus Code. Le cas échéant, vous devez également indiquer le numéro de l'appartement ou de l'unité.

Vous pouvez également fournir une adresse "composite". Utilisez les éléments enfants <component> pour décrire chacune des parties suivantes de l'adresse :

  • addr1 : adresse postale principale.
  • addr2 : adresse postale secondaire, y compris le numéro du bâtiment, si nécessaire.
  • city : ville.
  • province : État, région ou province, le cas échéant.
  • postal_code : code postal.
  • country : pays.

Notez que les boîtes postales et les agences de réception de courrier ne sont pas considérées comme des adresses physiques à part entière.

Voici des exemples d'adresses complètes :

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

Voici des exemples d'adresses complètes utilisant un 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>

Évitez les réflexes suivants :

  • Informations redondantes : n'incluez pas d'informations superflues ni de composants d'adresse répétés.
  • Adresse postale incomplète : les adresses doivent comporter un nom et un numéro de rue.

Exemple de fiche de location de vacances

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