Attributs

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

La structure XML générale se présente de la même manière que les flux pour les fiches d'hôtels. Voir Documentation de référence XML pour les listes d'hôtels

Si vous n'incluez pas les éléments obligatoires suivants, le annonce:

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

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

Pour en savoir plus sur les locations de vacances, consultez Attributs propres aux locations de vacances :

Enfin, lorsque Google détermine à partir d'autres sources que la valeur d'une attribute est différent de à ce qui est spécifié dans le flux d'une fiche de location de vacances, Google affiche le pour la fiche. Par exemple, si Google détermine à partir des photos d'une fiche qu'il y a une cuisine, mais que l'attribut kitchen est absent ou défini sur No, Google considère que cette fiche possède une cuisine. Ces attributs sont appelés "attributs déduits" et ne s'affichent que lorsqu'il existe un niveau de confiance élevé la justesse de l'inférence.

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

Le tableau suivant fournit une liste des valeurs valides pour attribute_name dans l'élément <client_attr name="attribute_name"> ; mais il est 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 supérieur ou égal à « 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 le les conditions d'hygiène 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 autorise l'arrivée et le départ sans hésiter. Yes/No/Unknown
rating Strongly recommended Nombre à virgule flottante représentant la note globale de l'établissement. Ce est généralement comprise entre 0 et 5, entre 0 et 10, ou entre 0 et 100, mais vous pouvez utiliser n'importe quelle plage qui représente votre système de notation. Non-negative float value
rating_num Strongly recommended Nombre de notes attribuées à 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 départ. L'alternative est l'attente d'approbation. Yes/No/Unknown
description Strongly recommended Texte à forme libre décrivant les qualités uniques de la propriété Free text
category Strongly recommended Type de logement (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 à proximité du . Yes/No/Unknown
check_in_time Recommended Heure exacte de la journée d'arrivée dans l'établissement. HHMM, HH:MM ou HH:MM:SS format accepté. Par exemple, indiquez 14:00 au lieu de 14:00 ou 14:00. Tout les autres formats ne seront ni analysés, ni affichés. Time
check_out_time Recommended Heure exacte de départ de l'établissement. HHMM, HH:MM ou HH:MM:SS format accepté. Par exemple, indiquez 11:00 au lieu de 11:00 ou 11:00. Tout les autres formats ne seront ni 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 à l'avance pendant lesquels 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 dans l'établissement. Free/Paid/None
patio Recommended Indique si l'établissement possède un patio. Yes/No/Unknown
pets_allowed Recommended Certaines chambres ou la totalité d'entre elles permettent aux clients d'amener des animaux de compagnie : des chiens ou des chats 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-fumeur. 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 Superficie de la propriété en pieds carrés. Non-negative float value
square_meters Recommended Surface 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 Le mode de transport depuis/vers l'aéroport ou d'autres sur les 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 la location de vacances. Free text
host_language Optional Langues parlées par l'organisateur. Une liste de valeurs séparées par une virgule langue codes, Exemple: de, en
host_name Optional Nom de l'hébergeur 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) requis pour les établissements dans certaines régions du monde. Elle peut être répétée et, si plusieurs licence existent, nous vous suggérons d'ajouter l'autorité de la licence comme contexte ; 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 cette fiche. La valeur doit être une ISO 3116 Code pays à deux lettres par exemple, aux États-Unis est US alors que le Canada est CA: 
    <country>US</country>
<id> Required string Identifiant unique de l'établissement. Notez que chaque location de vacances doit avoir un identifiant propre à votre site, et il ne doit jamais être réutilisés.
<latitude> Required float Latitude de l'emplacement de l'hôtel. Pour Exemple: 
    <latitude>37.423738</latitude>

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

Cette valeur peut être générée à l'aide d'outils de geocoding tels que 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. S'il n'en existe aucun, l'adresse doit inclure un plus code. Les numéros d'appartement ou de bureau doivent également être indiqués, le cas échéant.

Vous pouvez également fournir une image "composite" adresse e-mail. Utiliser <component> enfant pour décrire chacune des parties suivantes de l'adresse:

  • addr1: adresse postale principale
  • addr2: si nécessaire, l'adresse postale secondaire, y compris le numéro d'unité.
  • city: ville
  • province: si nécessaire, l'État, la région ou la province.
  • postal_code: code postal.
  • country: pays

Notez que les bons de commande les boîtes ou les autres adresses postales ne sont pas considérées comme des adresses physiques complètes.

Voici des exemples d'adresse complète:

<address> 6 Acacia Ave Apt. 2, Sidney, V8L 3B8, Canada</address>

<address>
  <component name="addr1">6 Acacia Ave</component>
  <component name="addr2">Apt. 2</component>
  <component name="city">Sidney</component>
  <component name="postal_code">V8L 3B8 9TQ</component>
  <component name="country">Canada</component>
</address>

Voici des exemples d'adresse complète utilisant un plus code:

<address>84WRMJ53+HM, Sidney, V8L 3B8, Canada</address>

<address>
  <component name="addr1">84WRMJ53+HM</component>
  <component name="city">Sidney</component>
  <component name="postal_code">V8L 3B8 9TQ</component>
  <component name="country">Canada</component>
</address>

Évitez ce qui suit:

  • Informations redondantes: n'incluez pas d'informations superflues ni d'éléments d'adresse répétés.
  • Adresse postale manquante: l'adresse doit comporter un nom et un numéro de rue.

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