Attributs

Cette page décrit les descriptions, les valeurs et les exigences des attributs et des éléments enfants. 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 XML pour les listes d'hôtels.

Si vous ne fournissez pas les éléments obligatoires suivants, la fiche est automatiquement désactivée:

  • Éléments enfants XML obligatoires: id, name, latitude, longitude et address.
  • Attributs obligatoires: capacity et website. Reportez-vous aux liens directs pour les locations de vacances dans votre flux de fiches. Cela permet aux utilisateurs de consulter le site Web de la propriété.

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

Pour en savoir plus sur les locations de vacances, consultez la section Attributs propres 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 annonce de location de vacances, Google affiche la valeur de l'annonce. 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" et ne s'affichent que lorsque la précision de l'inférence est élevée.

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 attribute_name supplémentaires, le cas échéant.

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 égale ou supérieure à "nombre_de_chambres". Non-negative integer value
website Required URL du site Web de l'établissement. 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 valeur n'est spécifiée, la valeur par défaut de rating_scale est comprise entre 0 et 10.

Non-negative integer value
instant_bookable Strongly recommended Indique si l'établissement peut être réservé instantanément durant le processus de paiement. L'alternative est l'attente d'approbation. Yes/No/Unknown
description Strongly recommended Texte libre décrivant les caractéristiques uniques de la propriété Free text
category Strongly recommended Type d'établissement (villa, bungalow, chalet ou appartement, par exemple) 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 exacte d'arrivée dans l'établissement. Format HHMM, HH:MM ou HH:MM:SS accepté. Par exemple, utilisez 14:00 au lieu de 14h00 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 la propriété est équipée d'un poêle. Yes/No/Unknown
parking_type Recommended Type de parking disponible pour 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 et/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 chambre. ENTIRE_PLACE est la seule valeur acceptée. ENTIRE_PLACE
smoking_free_property Recommended Indique si l'établissement est non-fumeur ou si le fumage est interdit. 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. Par exemple, verified, luxury, premium Yes/No/Unknown
square_footage Recommended Surface de l'établissement en pieds carrés. Non-negative float value
square_meters Recommended Superficie de la propriété 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/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 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 Obligatoire ? Type Description
<country> Strongly recommended string Pays dans lequel se trouve l'hôtel. La valeur doit être un code pays à deux lettres ISO 3116. Par exemple, les États-Unis sont US et le Canada est 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 geocoding 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 aucun n'existe, l'adresse doit inclure un Plus Code. Le cas échéant, vous devez également indiquer le numéro de l'appartement ou du bâtiment.

Vous pouvez également fournir une adresse "composite". Utilisez des é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 de l'unité, si nécessaire.
  • city: ville.
  • province: le cas échéant, l'État, la région ou la province.
  • postal_code: code postal.
  • country: pays.

Veuillez noter que les boîtes postales et les boîtes de domiciliation ne sont pas considérées comme des adresses physiques à part entière.

Voici des exemples d'adresse complète:

<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'adresse complète 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 éléments suivants:

  • Informations redondantes: n'incluez pas d'informations superflues ni de composants d'adresse en double.
  • Adresse manquante: 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>