Attributs

Cette page décrit les descriptions, les valeurs et les exigences concernant les attributs et les éléments enfants. Ces valeurs ne s'appliquent qu'aux locations de vacances.

La structure XML générale présente un format semblable à celui des flux pour les fiches d'hôtel. Consultez la documentation de référence XML pour les listes d'hôtels.

Si vous n'incluez pas les éléments obligatoires suivants, la fiche est automatiquement désactivée.

• Éléments enfants XML obligatoires: id, name, latitude, longitude, address.
• Attributs obligatoires: capacity et website.
  • Reportez-vous au lien direct du site Web vers la propriété dans votre flux de fiches. Cela donne aux utilisateurs la possibilité de visiter le site Web de l'établissement.

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

Pour en savoir plus sur les locations de vacances, consultez la section 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 d'une fiche de location de vacances, nous affichons la valeur de la fiche. Par exemple, si nous déterminons, à partir des photos d'une fiche, qu'il y a une cuisine, mais que l'attribut kitchen est absent ou défini sur No, nous considérons que la fiche dispose d'une cuisine. Ces attributs sont appelés "attributs déduits" et ne s'affichent que lorsque nous sommes convaincus de la précision de l'inférence.

Important :Pour les locations de vacances, les services sont fournis via les attributs de votre flux Hotel List Feed.

Valeurs de l'espace réservé "attribute_name"

Le tableau suivant fournit une liste de valeurs valides pour attribute_name dans l'élément <client_attr name="attribute_name">. Nous vous recommandons toutefois de fournir des attribute_name supplémentaires, le cas échéant.

Valeurs pour attribute_name	Requis ?	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_chambres".	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 la conformité de la fiche.	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 permet l'arrivée et le départ en libre-service.	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, entre 0 et 10 ou entre 0 et 100, mais vous pouvez utiliser n'importe quelle plage représentant votre système de classification.	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	Non-negative integer value
instant_bookable	Strongly recommended	Indique si l'établissement peut être réservé instantanément via le processus de paiement. L'alternative est en attente d'approbation.	Yes/No/Unknown
description	Strongly recommended	Texte libre décrivant les qualités uniques de l'établissement	Free text
category	Strongly recommended	Type de bien (villa, bungalow, cabane ou appartement, par exemple)	Free text
ac	Recommended	Indique si l'établissement est climatisé.	Yes/No/Unknown
beach_access	Recommended	Indique si l'établissement a accès à une plage publique proche de l'établissement.	Yes/No/Unknown
check_in_time	Recommended	Heure exacte de la journée d'arrivée dans l'établissement. Le format HHMM, HH:MM ou HH:MM:SS est accepté. Par exemple, utilisez 14h au lieu de 14h ou 14h. Aucun autre format ne sera analysé ni affiché.	Time
check_out_time	Recommended	Heure exacte de départ de l'établissement. Le format HHMM, HH:MM ou HH:MM:SS est accepté. Par exemple, utilisez 11:00 au lieu de 11h ou 11h. Aucun autre format ne sera analysé ni affiché.	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
minimum_days_advance_purchase	Recommended	Nombre minimal de jours à l'avance pendant lesquels l'établissement peut être réservé.	Non-negative integer value
minimum_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 la propriété est équipée d'un poêle.	Yes/No/Unknown
parking_type	Recommended	Type de parking disponible sur l'établissement.	Free/Paid/None
patio	Recommended	Indique si l'établissement possède un patio.	Yes/No/Unknown
pets_allowed	Recommended	Certaines ou toutes les chambres permettent aux clients d'amener les animaux de compagnie (chiens ou chats qui ne sont pas des 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
smoking_free_property	Recommended	Indique si l'établissement est non-fumeur ou non.	Yes/No/Unknown
special_service_level	Recommended	Indique si le niveau de service de la fiche est spécial d'une manière ou d'une autre. Exemple : verified, luxury, premium	Yes/No/Unknown
square_footage	Recommended	Surface du bien en pieds carrés.	Non-negative float value
square_meters	Recommended	Surface du bien 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ébergeur de location de vacances.	Free text
host_language	Optional	Langues parlées par l'organisateur.	Liste de codes de langue séparés par une virgule. Exemples: 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 (touristique ou professionnelle) devant être affiché 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 l'autorité de la licence comme 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 salles de séjour.	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 de l'établissement.	Free text

Éléments enfants XML

Les éléments enfants XML suivants sont obligatoires:

Élément enfant	Requis ?	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, pour les États-Unis est US et le Canada est CA : <country>US</country>
<id>	Required	string	Identifiant unique de l'établissement. Notez que chaque location de vacances doit être associée à un identifiant propre à votre site. Cet identifiant 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 à l'aide d'outils de geocoding 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 à l'aide d'outils de geocoding tels que l'API Google Maps.
<name>	Required	string	Nom de la propriété. 300 caractères maximum.
<address>	Required	Object or string	Emplacement physique complet de la propriété. Cet élément comporte un seul attribut, format, que vous devez définir sur simple. Vous devez au moins indiquer l'adresse postale, la ville, l'État ou la région, ainsi que le code postal de l'établissement. Utilisez les éléments enfants <component> pour décrire chacune des parties suivantes de l'adresse: addr1: adresse postale principale de l'établissement. addr2: adresse postale secondaire, y compris le numéro d'unité, si nécessaire addr3: troisième partie de l'adresse postale. city: nom de la ville de l'établissement. province: nom de l'État, de la région ou de la province de la propriété. postal_code: code postal de l'établissement. Exemple : <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> Vous pouvez également fournir une adresse à format libre, bien que cela ne soit pas recommandé. Exemple : <address>6 Elm Ave Unit 3, Boston, MA, 02472</address> Notez que les boîtes postales et les autres adresses postales ne sont pas considérées comme des adresses physiques à part entière.

Exemple de fiche de locations 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="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>