Documentation de référence XML pour les listes d'hôtels

Une liste d'hôtels se compose d'un ou de plusieurs fichiers XML répertoriant tous les hôtels pour lesquels vous fournissez des informations tarifaires. Le fichier de liste d'hôtels en lui-même ne contient aucune information tarifaire.

L'élément racine d'une liste d'hôtels est l'élément <listings>. Cet élément contient des éléments <listing> qui décrivent vos établissements.

Vous créez une liste d'hôtels dans le cadre de votre mise en œuvre initiale, puis vous y ajoutez ou supprimez des hôtels au fil de votre maintenance régulière.

Après avoir créé une liste d'hôtels, vous pouvez l'importer manuellement sur Google à l'aide de Hotel Center ou l'héberger sur votre serveur.

Exigences concernant les fiches

Pour pouvoir participer au programme Google Hotel Ads, chaque établissement présent sur votre liste d'hôtels doit remplir les conditions suivantes :

  • Disposer de chambres où des clients peuvent loger
  • Avoir une présence physique et un emplacement fixe ouvert au public
  • Disposer de murs fixes et d'un système de plomberie
  • Ne pas imposer une durée minimale de séjour supérieure à 7 jours

Les croisières et les appartements font partie des établissements non éligibles, car ils ne répondent généralement pas aux critères ci-dessus.

Les chalets et autres établissements de camping avec des murs fixes, ainsi que des systèmes de plomberie et de contrôle de la température (poêles à bois et radiateurs au propane inclus), sont éligibles. Les logements d'extérieur qui ne sont pas éligibles sont les suivants :

  • Terrains de camping où les clients dorment dans des tentes
  • Aires de camping-cars où les clients garent leurs propres véhicules de loisirs

<listings>

<listings> est l'élément racine d'une liste d'hôtels. Il contient un élément <language> et au moins un élément <listing>.

L'élément <listings> apparaît à l'emplacement suivant dans la hiérarchie XML de liste d'hôtels :

+ <listings>
    + <language>
    + <listing>

Syntaxe

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

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="xsi"
    xsi:noNamespaceSchemaLocation="schema_xsd">
  <language>language_code</language>
  <listing>listing</listing>
  ...
</listings>

Attributs

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

Attribut Valeur requise ? Description
xmlns:xsi Obligatoire À définir sur "http://www.w3.org/2001/XMLSchema-instance".
xsi:noNamespaceSchemaLocation Obligatoire À définir sur "https://www.gstatic.com/localfeed/local_feed.xsd".

Éléments enfants

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

Élément enfant Valeur requise ? Type Description
<language> Obligatoire Chaîne Langue dans laquelle votre flux est écrit. Définissez la valeur de cet élément sur un code de langue à deux lettres. Par exemple : "en" pour l'anglais.
<listing> Obligatoire <listing> Une ou plusieurs entrées décrivant chaque hôtel du flux. Notez que chaque hôtel de la liste doit posséder un ID propre à votre site, et que cet ID ne doit jamais être réutilisé.

Exemples

Adresse structurée

L'exemple suivant présente une liste d'hôtels partielle avec une adresse structurée :

<?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>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <address format="simple">
      <component name="addr1">666 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>
    <country>UK</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
  </listing>
  ...
</listings>

Adresse de forme libre

L'exemple suivant présente une liste d'hôtels partielle avec une adresse de forme libre :

<?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>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <address>666 Acacia Ave, Floor 5, Boston, MA, 02472</address>
    <country>US</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
  </listing>
  ...
</listings>

Contenu facultatif

L'exemple suivant présente une liste d'hôtels partielle avec une fiche contenant un élément <content> facultatif :

<?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="2017"/>
      </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="2017"/>
        <servicedate day="16" month="6" year="2017"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="star_rating">4</client_attr>
        <client_attr name="num_reviews">14</client_attr>
        <client_attr name="air_conditioned">Yes</client_attr>
        <client_attr name="has_beach_access">No</client_attr>
        <client_attr name="has_free_breakfast">Yes</client_attr>
        <client_attr name="has_spa">No</client_attr>
        <client_attr name="number_of_rooms">5</client_attr>
        <client_attr name="pets_allowed">Yes</client_attr>
        <client_attr name="wheelchair_accessible">Yes</client_attr>
        <client_attr name="kitchen_availability">Available in all rooms</client_attr>
        <client_attr name="parking_type">No payment required</client_attr>
        <client_attr name="swimming_pool_type">Indoors</client_attr>
        <client_attr name="wifi_type">Paid</client_attr>
      </attributes>
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main hotel picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

<listing>

Définition d'hôtel dans l'élément <listings> d'une liste d'hôtels.

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

+ <listings>
    + <language>
    + <listing>

Syntaxe

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

<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
  <listing>
    <!-- Specify <listing>'s child elements in the order shown below. -->
    <id>hotel_ID</id>
    <name>hotel_name</name>
    <address>
      <component name="addr1">street_address_1</component>
      <component name="addr2">street_address_2</component>
      <component name="city">city_name</component>
      <component name="province">province_name</component>
      <component name="postal_code">postal_code</component>
    </address>
    <!-- You can also define an address freeform, although this is not recommended: -->
    <!-- <address>freeform_address</address> -->

    <country>country_code</country>
    <latitude>hotel_latitude</latitude>
    <longitude>hotel_longitude</longitude>
    <phone type="[fax|main|mobile|tdd|tollfree]">phone_number</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
    <content>content</content>
  </listing>
</listings>

Attributs

L'élément <listing> ne comporte aucun attribut.

Éléments enfants

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

Élément enfant Valeur requise ? Type Description
<id> Obligatoire Chaîne Identifiant unique de l'hôtel.
<name> Obligatoire Chaîne Nom de l'hôtel. Par exemple :

<name>Belgrave House</name>
<address> Obligatoire Objet ou chaîne

Emplacement physique complet de l'hôtel.

Cet élément comporte un seul attribut (format) que vous devez définir sur "simple".

Vous devez au minimum fournir l'adresse postale, la ville, l'État/la région et le code postal de l'hôtel. Utilisez les éléments enfants <component> pour décrire chacune des parties suivantes de l'adresse :

  • addr1 : adresse postale principale de l'hôtel.
  • addr2 : adresse postale secondaire, si nécessaire.
  • addr3 : troisième partie de l'adresse postale, si nécessaire.
  • city : nom de la ville de l'hôtel.
  • province : nom de l'État, de la région ou de la province de l'hôtel.
  • postal_code : code postal de l'hôtel.

Par exemple :


<address format="simple">
  <component name="addr1">666 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 de forme libre, bien que cela ne soit pas recommandé. Par exemple :


<address>666 Acacia Ave, Floor 5, Boston, MA, 02472</address>

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.

<country> Obligatoire Chaîne Pays dans lequel se trouve l'hôtel. La valeur indiquée doit être un code pays à deux lettres majuscules ISO 3116. Exemple : le code des États-Unis est "US" et celui du Canada est "CA". Par exemple :

<country>US</country>
<latitude> Obligatoire* Float Latitude de l'emplacement de l'hôtel. Par exemple :

<latitude>37.423738</latitude>

Cette valeur peut être générée avec des outils de geocoding tels que l'API Google Maps.

<longitude> Obligatoire* Float Longitude de l'emplacement de l'hôtel. Par exemple :

<longitude>-122.090101</longitude>

Cette valeur peut être générée avec des outils de geocoding tels que l'API Google Maps.

<location_precision> Facultatif Entier Précision de l'emplacement de l'établissement envoyée en mètres lorsque la latitude et la longitude sont obscurcies. La valeur zéro (0) signifie une absence d'obscurcissement : l'emplacement exact est fourni. Remarque : Cet élément ne s'applique qu'aux locations de vacances.
<phone> Obligatoire* Chaîne

Un ou plusieurs numéros de téléphone pour l'hôtel. S'il s'agit d'une succursale, indiquez le numéro de téléphone propre à cette succursale (et non celui du siège).

Les valeurs possibles pour l'attribut type sont les suivantes :

  • fax : numéro de fax.
  • main : numéro de téléphone principal.
  • mobile : numéro de téléphone mobile.
  • tdd : numéro de téléphone pour personne malentendante.
  • tollfree : numéro de téléphone gratuit.

Par exemple :


<!-- Singapore (country code +65) -->
<phone type="main">+65 6722-2323</phone>
<!-- U.S. (country code +1) -->
<phone type="fax">+1 408-555-1111</phone>

Vous devez au minimum fournir le type main.

* Vous devez obligatoirement indiquer un numéro de téléphone OU des coordonnées latitude/longitude. Nous vous recommandons de définir les deux.
<category> Facultatif Chaîne Type d'établissement, tel qu'un hôtel. Les partenaires peuvent utiliser n'importe quelle catégorie interne pour décrire leur établissement, par exemple "hôtels d'affaires", "complexes hôteliers", "motels" ou autres.
<content> Facultatif <content> Informations facultatives utilisées pour la fiche, telles qu'une description, des avis et des caractéristiques de l'établissement.

Exemples

Adresse structurée

L'exemple suivant présente une liste d'hôtels partielle avec une adresse structurée :

<?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>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <address format="simple">
      <component name="addr1">666 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>
    <country>UK</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
  </listing>
  ...
</listings>

Adresse de forme libre

L'exemple suivant présente une liste d'hôtels partielle avec une adresse de forme libre :

<?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>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <address>666 Acacia Ave, Floor 5, Boston, MA, 02472</address>
    <country>US</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
  </listing>
  ...
</listings>

Contenu facultatif

L'exemple suivant présente une liste d'hôtels partielle avec une fiche contenant un élément <content> facultatif :

<?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="2017"/>
      </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="2017"/>
        <servicedate day="16" month="6" year="2017"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="star_rating">4</client_attr>
        <client_attr name="num_reviews">14</client_attr>
        <client_attr name="air_conditioned">Yes</client_attr>
        <client_attr name="has_beach_access">No</client_attr>
        <client_attr name="has_free_breakfast">Yes</client_attr>
        <client_attr name="has_spa">No</client_attr>
        <client_attr name="number_of_rooms">5</client_attr>
        <client_attr name="pets_allowed">Yes</client_attr>
        <client_attr name="wheelchair_accessible">Yes</client_attr>
        <client_attr name="kitchen_availability">Available in all rooms</client_attr>
        <client_attr name="parking_type">No payment required</client_attr>
        <client_attr name="swimming_pool_type">Indoors</client_attr>
        <client_attr name="wifi_type">Paid</client_attr>
      </attributes>
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main hotel picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

<content>

Ajoute des informations sur une fiche, telles que des notes et des avis, des services et d'autres informations. L'élément <content> est facultatif. Dans <content>, tous les éléments enfants sont facultatifs.

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

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

Syntaxe

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

<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
  <listing>
    <content>
      <!-- Specify <text>'s child elements in the order shown below. -->
      <text type="description">
        <link>listing_link</link>
        <title>listing_title</title>
        <author>listing_author</author>
        <body>listing_description</body>
        <date month="MM" day="DD" year="YYYY"/>
      </text>
      <!-- 0 or more reviews: -->
      <review type="[editorial|user]">
        ...
      </review>
      <!-- 0 or more attributes: -->
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="air_conditioned">[No|Yes]</client_attr>
        <client_attr name="all_inclusive_available">[No|Yes]</client_attr>
        <client_attr name="alternate_hotel_id">alternate_hotel_id</client_attr>
        <client_attr name="child_friendly">[No|Yes]</client_attr>
        <client_attr name="custom_0">custom_attribute_0</client_attr>
        <client_attr name="custom_1">custom_attribute_1</client_attr>
        <client_attr name="custom_2">custom_attribute_2</client_attr>
        <client_attr name="custom_3">custom_attribute_3</client_attr>
        <client_attr name="custom_4">custom_attribute_4</client_attr>
        <client_attr name="has_affiliated_golf_course">[No|Yes]</client_attr>
        <client_attr name="has_airport_shuttle">[No|Yes]</client_attr>
        <client_attr name="has_bar_or_lounge">[No|Yes]</client_attr>
        <client_attr name="has_beach_access">[No|Yes]</client_attr>
        <client_attr name="has_business_center">[No|Yes]</client_attr>
        <client_attr name="has_fitness_center">[No|Yes]</client_attr>
        <client_attr name="has_free_breakfast">[No|Yes]</client_attr>
        <client_attr name="has_hot_tub">[No|Yes]</client_attr>
        <client_attr name="has_laundry_service">[No|Yes]</client_attr>
        <client_attr name="has_restaurant">[No|Yes]</client_attr>
        <client_attr name="has_room_service">[No|Yes]</client_attr>
        <client_attr name="has_spa">[No|Yes]</client_attr>
        <client_attr name="hotel_brand">hotel_brand</client_attr>
        <client_attr name="kitchen_availability">[Available in all rooms|Available in some rooms|
          Not available]</client_attr>
        <client_attr name="number_of_rooms">rooms_per_unit</client_attr>
        <client_attr name="num_reviews">number_of_reviews</client_attr>
        <client_attr name="parking_type">[No payment required|Paid|Not available]</client_attr>
        <client_attr name="pets_allowed">[No|Yes]</client_attr>
        <client_attr name="rating">aggregate_rating</client_attr>
        <client_attr name="star_rating">[1|2|3|4|5]</client_attr>
        <client_attr name="smoke_free_property">[No|Yes]</client_attr>
        <client_attr name="swimming_pool_type">[Indoors|Outdoors|Indoors and outdoors|Not available]</client_attr>
        <client_attr name="wheelchair_accessible">[No|Yes]</client_attr>
        <client_attr name="wifi_type">[Not available|No payment required|Paid]</client_attr>
      </attributes>
      <!-- a picture of the hotel or property-->
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main Hotel Picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

Attributs

L'élément <content> ne comporte aucun attribut.

Éléments enfants

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

Élément enfant Valeur requise ? Type Description
<text 
type=
"description">
Facultatif Objet

Page Web associée à la fiche du fournisseur. Comporte les éléments enfants suivants :

  • <link> : lien vers la description. Incluez "http://" ou
    "https://" dans cet élément (facultatif).
  • <title> : titre de la description (facultatif).
  • <author> : auteur de la description (facultatif).
  • <body> : corps de la description (obligatoire).
  • <date> : date de la description (facultative).
  • Remarque : Ces éléments doivent apparaître dans l'ordre ci-dessus.

<review 
type=
"[editorial|user]">
Facultatif <review>

Contient un avis d'utilisateur ou de journaliste de la fiche. Votre fiche peut contenir un nombre illimité d'avis, quel que soit leur type.

Il n'est pas nécessaire d'inclure tous les avis sur un établissement 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.

<attributes> Facultatif Objet

Contient 0, un ou plusieurs éléments enfants <client_attr> qui fournissent des détails sur l'établissement. Les éléments enfants utilisent la syntaxe suivante :


<client_attr name="attribute_name">attribute_value<client_attr>

Pour obtenir la liste et la description des éléments enfants, consultez la section <attributes>.

Tous les éléments <client_attr> sont facultatifs.

Si un élément enfant <website> est présent, il doit être positionné avant tout élément <client_attr>.

<image> Facultatif Objet Tag répété contenant des informations détaillées sur l'image.

Exemple

L'exemple suivant présente une liste d'hôtels partielle incluant l'élément <content> :

<?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="2017"/>
      </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="2017"/>
        <servicedate day="16" month="6" year="2017"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="star_rating">4</client_attr>
        <client_attr name="num_reviews">14</client_attr>
        <client_attr name="air_conditioned">Yes</client_attr>
        <client_attr name="has_beach_access">No</client_attr>
        <client_attr name="has_free_breakfast">Yes</client_attr>
        <client_attr name="has_spa">No</client_attr>
        <client_attr name="number_of_rooms">5</client_attr>
        <client_attr name="pets_allowed">Yes</client_attr>
        <client_attr name="wheelchair_accessible">Yes</client_attr>
        <client_attr name="kitchen_availability">Available in all rooms</client_attr>
        <client_attr name="parking_type">No payment required</client_attr>
        <client_attr name="swimming_pool_type">Indoors</client_attr>
        <client_attr name="wifi_type">Paid</client_attr>
      </attributes>
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main hotel picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

<review>

Contient un avis d'utilisateur ou de journaliste. Il n'est pas nécessaire d'inclure tous les avis sur un établissement 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 Valeur requise ? Description
type Obligatoire 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 client final.

Éléments enfants

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

Élément enfant Valeur requise ? Type Description
<link> Facultatif Chaîne Lien vers l'avis. Incluez "http://" ou "https://" dans cet élément (facultatif).
<title> Facultatif Chaîne (Avis de journalistes uniquement) Titre de l'avis.
<author> Facultatif Chaîne 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> Facultatif Chaîne Nombre à virgule flottante compris entre 0 et 10 (inclus) représentant la note de l'avis. Par exemple, "8,9".
<body> Facultatif Chaîne Texte de l'avis. Cet élément ne doit pas contenir de code HTML.
<date month="MM" day="DD" year="YYYY"/> Facultatif Objet (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 : "3".
  • month : mois, (1 = janvier). Par exemple : "12".
  • year : année à quatre chiffres, par exemple : "2018".

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


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

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


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

Notez que <title> n'est un élément enfant valide de <review> que si type pour l'avis est editorial, et <date> n'est valide que si type est user.

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="2017"/>
      </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="2017"/>
        <servicedate day="16" month="6" year="2017"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="star_rating">4</client_attr>
        <client_attr name="num_reviews">14</client_attr>
        <client_attr name="air_conditioned">Yes</client_attr>
        <client_attr name="has_beach_access">No</client_attr>
        <client_attr name="has_free_breakfast">Yes</client_attr>
        <client_attr name="has_spa">No</client_attr>
        <client_attr name="number_of_rooms">5</client_attr>
        <client_attr name="pets_allowed">Yes</client_attr>
        <client_attr name="wheelchair_accessible">Yes</client_attr>
        <client_attr name="kitchen_availability">Available in all rooms</client_attr>
        <client_attr name="parking_type">No payment required</client_attr>
        <client_attr name="swimming_pool_type">Indoors</client_attr>
        <client_attr name="wifi_type">Paid</client_attr>
      </attributes>
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main hotel picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

<attributes>

Le tag <attributes> permet de décrire les services de l'établissement, ainsi que de classer les notes et les avis sur cet établissement.

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

Remarque : Tous les attributs sont facultatifs.

Éléments enfants

Élément enfant Valeur requise ? Description
<website> Facultatif Site Web principal de l'hôtel. S'il est présent, il doit être placé avant le premier élément <client_attr>. Exemple :

<website>https://hotel.example.com</website>
<client_attr name="attribute_name"> Facultatif Caractéristique supplémentaire ou "attribut" de l'établissement pouvant être spécifié à l'aide d'une valeur attribute_name actuellement prise en charge ou d'une valeur attribute_name pour les locations de vacances.

Valeurs de l'espace réservé attribute_name

Le tableau suivant répertorie les valeurs valides pour attribute_name dans l'élément <client_attr name="attribute_name">.

Valeurs pour attribute_name Description Valeurs de contenu valides
air_conditioned Toutes les chambres de cet établissement sont climatisées. Oui/Non
all_inclusive_available Une chambre ou un tarif disponible inclut non seulement la chambre, mais tous les repas et boissons (y compris les boissons alcoolisées) pour la durée du séjour. Oui/Non
alternate_hotel_id Autre identifiant de votre établissement. Il peut s'avérer utile d'avoir des identifiants distincts si vous avez besoin de deux identifiants d'établissement : un pour les informations de votre flux et un autre pour votre moteur de réservation. N'importe quelle chaîne
child_friendly L'établissement propose une ou plusieurs caractéristiques spéciales pour les familles voyageant avec des enfants, comme des tarifs réduits, des berceaux ou lits pour enfants, un club pour enfants, un service de garde d'enfants ou un lieu de divertissement adapté aux enfants sur place. Oui/Non
custom_[0-4] Tout attribut personnalisé de type chaîne. Les utilisateurs ne le verront pas, mais il pourra servir à regrouper des hôtels dans les campagnes Google Ads. Cinq champs de ce type peuvent être utilisés sans être interchangeables. Par exemple, un hôtel comportant le champ custom_0 = "Centre-ville" ne sera pas regroupé avec un hôtel comportant le champ custom_4 = "Centre-ville". N'importe quelle chaîne
has_affiliated_golf_course Cet établissement dispose d'un parcours de golf soit sur place, soit à proximité. Il propose des réservations d'horaires de départ, ainsi qu'une navette pour les clients entre l'établissement et le parcours. L'usage du parcours de golf entraîne souvent des frais. Oui/Non
has_airport_shuttle Cet établissement propose une navette aéroport, gratuite ou payante. Il peut s'agir d'une navette qui s'arrête dans plusieurs hôtels à condition qu'un arrêt explicite soit proposé pour cet hôtel. Oui/Non
has_bar_or_lounge L'établissement possède un bar ou un lounge intérieur et/ou extérieur qui sert des boissons alcoolisées. Les clients n'ont pas besoin de quitter l'établissement pour accéder au bar ou au lounge. Oui/Non
has_beach_access Cet établissement dispose d'une plage directement accessible sans traverser de route publique. Oui/Non
has_business_center Cet établissement possède une salle avec ordinateur, accès Internet et imprimante disponibles pour les clients qui ont besoin d'un espace de travail gratuit ou payant sur place pour exercer leur activité. Oui/Non
has_fitness_center L'établissement possède un centre de remise en forme. Les clients n'ont pas besoin de quitter l'établissement pour accéder au centre de remise en forme. Oui/Non
has_free_breakfast Le petit-déjeuner est gratuit pour tous les clients chaque jour de la semaine, quel que soit le prix de la chambre. Si l'hôtel propose un prix de chambre incluant le petit-déjeuner et un prix de chambre sans petit-déjeuner, vous devez indiquer false pour cet attribut. Oui/Non
has_hot_tub Une partie ou l'intégralité des chambres est dotée d'un bain à remous ou d'un jacuzzi, ou l'établissement dispose d'un bain à remous sur place. Des frais supplémentaires peuvent s'appliquer pour le bain à remous. Oui/Non
has_laundry_service Les clients peuvent laisser leur linge à laver à la réception ou dans leur chambre, et le linge propre leur est rendu dans leur chambre. Des frais supplémentaires peuvent s'appliquer pour le service. La présence d'une laverie libre-service ne compte pas ici. Oui/Non
has_restaurant L'établissement possède un restaurant intérieur et/ou extérieur sur place. Les clients n'ont pas besoin de quitter l'établissement pour se rendre au restaurant. Oui/Non
has_room_service Les repas sont préparés sur place et amenés directement dans les chambres par le personnel. Les horaires du service de chambre peuvent être limités. Des frais supplémentaires peuvent s'appliquer. Oui/Non
has_spa L'établissement possède un spa qui propose un ou plusieurs des services gratuits ou payants suivants : massages, sauna et soins du visage. Les clients n'ont pas besoin de quitter l'établissement pour se rendre au spa. Oui/Non
hotel_brand Marque à laquelle appartient l'hôtel. Par exemple : "Marriott" ou "Hilton". Les utilisateurs ne la verront pas, mais elle pourra servir à regrouper des hôtels dans les campagnes Google Ads. N'importe quelle chaîne
kitchen_availability Les clients ont accès à une cuisine dans laquelle ils peuvent préparer des repas chauds et placer de la nourriture au réfrigérateur dans leur chambre.
  • Disponible dans toutes les chambres
  • Disponible dans certaines chambres
  • Non disponible
number_of_rooms Ce champ indique le nombre total d'unités associées à l'identifiant de la fiche. Remarque : Ce nombre ne représente pas le prix par unité de réservation en fonction des données tarifaires et de flux d'inventaire. Tout entier non négatif.
num_reviews Nombre d'avis sur la fiche. Tout entier non négatif.
parking_type Indique si un parking est disponible, et s'il est gratuit ou payant.
  • Aucun paiement requis
  • Payant
  • Non disponible
pets_allowed Une partie ou l'intégralité des chambres accueille les animaux de compagnie des clients (chiens et/ou chats hors animaux d'assistance). Oui/Non
rating 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.
smoke_free_property Il est interdit de fumer dans l'ensemble de l'établissement. Oui/Non
star_rating Nombre d'étoiles attribuées à l'établissement par un organisme de classification. 1, 2, 3, 4, 5.
swimming_pool_type Indique si une piscine est disponible dans l'établissement et, le cas échéant, le type de piscine.
  • En intérieur
  • En extérieur
  • En intérieur et en extérieur
  • Non disponible
wheelchair_accessible Cet établissement est accessible aux personnes en fauteuil roulant. Oui/Non
wifi_type Indique si l'établissement fournit un service Internet sans fil aux clients (Wi-Fi) dans toutes les parties de l'établissement (et non dans une zone spécifique). Ce service peut être gratuit ou payant.
  • Aucun paiement requis
  • Payant
  • Non disponible

Valeurs de l'espace réservé "attribute_name" pour les locations de vacances

Vous trouverez ci-dessous la liste des valeurs valides pour attribute_name dans l'élément <client_attr name="attribute_name">. Toutefois, les partenaires sont invités à fournir les valeurs attribute_name supplémentaires dont ils disposent. Ces valeurs ne s'appliquent qu'aux établissements de location de vacances.

Valeurs pour attribute_name Valeur requise ? Description Valeurs de contenu valides
capacity Obligatoire Nombre maximal de personnes que l'établissement peut accueillir. Entier non négatif
min_days_between_stays Facultatif (vivement recommandé) Nombre minimal de jours "tampon" pendant lesquels la location doit être vide après le départ des occupants précédents. Entier non négatif
enhanced_cleaning_practices Facultatif (vivement recommandé) Indique si l'établissement applique un protocole de nettoyage renforcé (avec sa description sur le site du partenaire). Oui/Non
partner_hygiene_link Facultatif (vivement recommandé) Lien vers le site externe du partenaire fournissant plus d'informations sur l'hygiène dans l'établissement. Texte libre (URL du site)
number_of_bathrooms Facultatif (vivement recommandé) Nombre de salles de bain. Valeur flottante non négative, par exemple : 1, 1,5, 2
number_of_bedrooms Facultatif (vivement recommandé) Nombre de chambres. Valeur entière non négative
number_of_beds Facultatif (vivement recommandé) Nombre de lits (dans toutes les chambres). Valeur entière non négative
self_checkin_checkout Facultatif (vivement recommandé) Indique si l'établissement autorise l'arrivée et le départ en autonomie. Oui/Non
rating_num Facultatif (vivement recommandé) Nombre de notes de l'établissement. Entier non négatif
ac Facultatif Indique si l'établissement est climatisé. Oui/Non
airport_shuttle Facultatif Indique si l'hôte assure le transport depuis/vers l'aéroport ou d'autres terminaux. Oui/Non
balcony Facultatif Indique si l'établissement possède un balcon. Oui/Non
beach_access Facultatif Indique si l'établissement est proche d'une plage publique. Oui/Non
cancellation_policy Facultatif Description libre des modalités d'annulation. Texte libre
cancellation_policy_type Facultatif

Les partenaires peuvent fournir n'importe quel nom de type de modalités. Google collabore avec le partenaire pour mettre en correspondance ce nom avec les types suggérés par Google. (Si vous fournissez des types personnalisés, veuillez les limiter à environ cinq catégories et transmettre les descriptions de ces types à votre responsable de compte.)

Suggestions de types de modalités d'annulation acceptées par l'hôte :

  • Aucun remboursement : aucun remboursement n'est proposé, quelles que soient la raison et la période.
  • Strictes : les réservations annulées au moins 60 jours avant le début du séjour sont intégralement remboursées.
  • Fermes : les réservations annulées au moins 60 jours avant le début du séjour sont intégralement remboursées. Les réservations annulées au moins 30 jours avant le début du séjour sont remboursées à 50 %.
  • Modérées : les réservations annulées au moins 30 jours avant le début du séjour sont intégralement remboursées. Les réservations annulées au moins 14 jours avant le début du séjour sont remboursées à 50 %.
  • Souples : les réservations annulées au moins 14 jours avant le début du séjour sont intégralement remboursées. Les réservations annulées au moins sept jours avant le début du séjour sont remboursées à 50 %.
Souples/Modérées/Fermes/Strictes/Aucun remboursement
check_in_time Facultatif Heure d'arrivée dans l'établissement. Texte libre
check_out_time Facultatif Heure précise de départ de l'établissement. Texte libre
child_friendly Facultatif Indique si l'établissement est adapté aux enfants. Oui/Non
crib Facultatif Indique si l'établissement fournit un berceau. Oui/Non
elevator Facultatif Indique si l'établissement dispose d'un ascenseur. Oui/Non
fire_place Facultatif Indique si l'établissement est doté d'une cheminée. Oui/Non
free_breakfast Facultatif Indique si l'établissement propose un petit-déjeuner gratuit. Oui/Non
gym_fitness_equipment Facultatif Indique si l'établissement dispose d'une salle de sport ou d'équipements de fitness. Oui/Non
heating Facultatif Indique si l'établissement dispose du chauffage.
hot_tub Facultatif Indique si l'établissement dispose d'un bain à remous. Oui/Non
instant_bookable Facultatif Indique si l'établissement peut être réservé instantanément via le processus de règlement. L'alternative est l'attente d'approbation. Oui/Non
ironing_board Facultatif Indique si l'établissement propose des planches à repasser. Oui/Non
kitchen Facultatif Indique si l'établissement est équipé d'une cuisine. Oui/Non
license_num Facultatif 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"). Texte libre
microwave Facultatif Indique si un four à micro-ondes est disponible dans l'établissement. Oui/Non
minimum_days_advance_purchase Facultatif Nombre minimal de jours avant la date d'arrivée où l'établissement peut être réservé. Entier non négatif
minimum_night_stay Facultatif Nombre minimal de nuits pendant lesquelles un client peut réserver l'établissement. Entier positif (supérieur à zéro)
max_night_stay Facultatif Nombre maximal de nuits pendant lesquelles un client peut réserver l'établissement. Entier positif (supérieur à zéro)
number_of_living_rooms Facultatif Nombre de salles de séjour. Valeur entière non négative
outdoor_grill Facultatif Indique si l'établissement est doté d'un barbecue. Oui/Non
oven_stove Facultatif Indique si la propriété est équipée d'un poêle. Oui/Non
parking_type Facultatif Type de parking disponible pour l'établissement. Gratuit/Payant/Aucun
patio Facultatif Indique si l'établissement possède un patio. Oui/Non
pets_allowed Facultatif Une partie ou l'intégralité des chambres accueille les animaux de compagnie des clients (chiens et/ou chats hors animaux d'assistance). Oui/Non
pool_type Facultatif Type de piscine (accès à la piscine) dont dispose l'établissement. En intérieur, En extérieur, En intérieur et en extérieur, Aucun
private_beach_access Facultatif Indique si l'établissement dispose d'un accès dédié à une plage non publique. Oui/Non
room_type Facultatif Type d'établissement partagé avec Google.
Remarque : Pour le moment, seul le type Établissement entier est accepté.
Établissement entier, Chambre partagée, Chambre privée
smoking_free_property Facultatif Indique si l'établissement est non-fumeur (interdiction de fumer). Oui/Non
square_footage Facultatif Surface de l'établissement. Valeur flottante non négative
tv Facultatif Indique si l'établissement est équipé d'une télévision. Oui/Non
washer_dryer Facultatif Indique si l'établissement est équipé d'appareils de buanderie. Oui/Non
wheelchair_accessible Facultatif Indique si l'établissement est accessible en fauteuil roulant. Oui/Non
wifi_type Facultatif Type d'accès Internet Wi-Fi fourni par l'établissement. Gratuit/Payant/Aucun
host_language Facultatif Langues parlées par l'hôte. Liste des codes de langue séparés par une virgule (par exemple : de,en)

Exemple 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">Detailed Address</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>
    <location_precision>500<location_precision>
    <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>
      <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">Yes</client_attr>
        <client_attr name="beach_access">Yes</client_attr>
        <client_attr name="cancellation_policy">50% deposit returnable before 4 weeks of arrival date, 100% refundable before 8 weeks of arrival</client_attr>
        <client_attr name="cancellation_policy_type">Moderate</client_attr>
        <client_attr name="check_in_time">3pm</client_attr>
        <client_attr name="check_out_time">11am</client_attr>
        <client_attr name="child_friendly">Yes</client_attr>
        <client_attr name="crib">Yes</client_attr>
        <client_attr name="elevator">Yes</client_attr>
        <client_attr name="fire_place">Yes</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">Yes</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">Yes</client_attr>
        <client_attr name="oven_stove">Yes</client_attr>
        <client_attr name="parking_type">Free</client_attr>
        <client_attr name="patio">Yes</client_attr>
        <client_attr name="pool_type">Indoors</client_attr>
        <client_attr name="private_beach_access">Yes</client_attr>
        <client_attr name="refund_policy">Cancellations made after 48 hours but before 24 hours prior to checkin will received a 50% refund</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>

<image>

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

Les images sont utilisées pour afficher l'établissement dans l'ID de fiche. Toutes les images utilisées doivent respecter les consignes suivantes :

  • Le format recommandé pour les images est 4:3.
  • Le robot d'exploration d'images Googlebot doit pouvoir accéder à l'URL de l'image.
  • Si votre site inclut un fichier robots.txt au niveau racine, vérifiez qu'il est compatible avec l'une des deux options ci-dessous :
    1. Permet au robot d'exploration Googlebot d'explorer le contenu de votre site, y compris les images.
      • User-agent : Googlebot
      • Autoriser : /
    2. Permet au robot d'exploration Googlebot d'explorer les images de votre site.
      • User-agent : Googlebot-Image
      • Autoriser : /
  • Les captures d'écran d'images ou de sites Web ne sont pas autorisées. Les images doivent être de véritables images ou photos originales.

Attributs

Nom d'attribut Valeur requise ? Format Description
type Obligatoire Texte

Le type d'une image doit être l'un des suivants :

  • "ad" si l'image est une publicité
  • "menu" si l'image est un menu de restaurant
  • "photo" si l'image est une photo de l'établissement
url Obligatoire Texte URL de l'image en taille réelle. Utilisez l'attribut "url" pour spécifier l'image à placer sur cette page.
width Obligatoire Entier non négatif Largeur de l'image en pixels (largeur supérieure à 720 pixels recommandée)
height Obligatoire Entier non négatif Hauteur de l'image en pixels (hauteur supérieure à 720 pixels recommandée)

Éléments enfants

Élément enfant Valeur requise ? Description
<link> Demandé, mais obligatoire pour les fiches avec photos locales. Ce tag contient l'URL valide et à jour de la page de votre site qui contient l'image concernée. Il ne contient pas l'URL de l'image en elle-même. Exemple :

<link><http://www.example.com/magic_pizza/></link>
<title> Demandé Ce tag contient le titre de l'image. Exemple :

<title>"Luxury Apartment"</title>
<author> Non demandé Nom de l'auteur du contenu. La valeur peut être un nom d'utilisateur ou un nom complet au format "Prénom Nom".
<date> Obligatoire

Ce tag permet d'indiquer la date de création de l'élément de contenu. Vous devez entrer une année, un mois et un jour, comme dans l'exemple suivant :


<date month="6" day="7" year="2017"/>

Exemple

L'exemple ci-dessous présente une liste partielle d'hôtels avec des tags d'images :

<?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>
    <content>
      <review>
      </review>
      <attributes>
      </attributes>
      <image type="photo" url="https://image_url" width="400" height="300">
        <link>https://image_url</link>
        <title>Apartment at Sandstone</title>
        <author>Jessica Landlord</author>
        <date month="6" day="7" year="2017"/>
      </image>
    </content>
  </listing>
  ...
</listings>

Consignes de syntaxe

Lorsque vous créez une liste d'hôtels XML, respectez les consignes suivantes :

  • Validez vos fichiers XML de liste d'hôtels à l'aide du schéma XSD de Google.
  • Utilisez l'encodage UTF-8. Spécifiez ce schéma d'encodage en incluant l'attribut encoding dans votre balise XML, comme illustré dans les exemples ci-dessous.
  • Vous pouvez spécifier des valeurs de données dans votre flux avec les sections CDATA. Si vous utilisez des sections CDATA, n'échappez pas les caractères spéciaux.
  • Utilisez des codes d'échappement pour les valeurs de données qui ne figurent pas dans les sections CDATA, y compris les URL. Vous pouvez employer le code de l'entité ou le code du caractère pour représenter ces caractères spéciaux.

    Le tableau suivant répertorie les codes d'entité et de caractère courants que vous pouvez utiliser :

    Caractère Entité Code du caractère
    Esperluète (&) &amp; &#38;
    Apostrophe (') &apos; &#39;
    Guillemets droits (") &quot; &#34;
    Supérieur à (>) &gt; &#62;
    Inférieur à (<) &lt; &#60;
  • Omettez les éléments XML qui ne contiennent pas de données. Par exemple, si vous ne disposez pas de la latitude ni de la longitude pour un hôtel, vous ne devez pas inclure des éléments <latitude/> et <longitude/> vides.
  • N'utilisez pas de code HTML dans vos éléments XML, quelles que soient les circonstances (même avec échappement).
  • Pour valider votre flux avant l'importation, vous pouvez utiliser le fichier XSD de flux local "https://www.gstatic.com/localfeed/local_feed.xsd".
  • Pour utiliser les commentaires dans votre flux, entourez-les des tags <!-- et -->, comme le montre l'exemple suivant :

    <!-- This is a comment -->
  • Veillez à fermer l'élément <date> dans un élément <review> d'utilisateur. Par exemple :

    <date day="2" month="12" year="2017"/>

Identifier et résoudre les problèmes de données

Pour identifier et résoudre les problèmes de données dans votre liste d'hôtels, vous pouvez utiliser les outils suivants :

Hotel Center :