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 ( 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
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
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 |
| * 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 |
Facultatif | Objet | Page Web associée à la fiche du fournisseur. Comporte les éléments enfants suivants :
Remarque : Ces éléments doivent apparaître dans l'ordre ci-dessus. |
<review |
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 |
<attributes> |
Facultatif | Objet | Contient 0, un ou plusieurs éléments enfants <client_attr name="attribute_name">attribute_value<client_attr> Pour obtenir la liste et la description des éléments enfants, consultez la section Tous les éléments Si un élément enfant |
<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 :
|
É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 :
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. |
|
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. |
|
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. |
|
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. |
|
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 :
|
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 :
- Permet au robot d'exploration Googlebot d'explorer le contenu de votre site, y compris les images.
- User-agent : Googlebot
- Autoriser : /
- 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 :
|
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
encodingdans 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 sectionsCDATA, 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 (&) & & Apostrophe (') ' ' Guillemets droits (") " " Supérieur à (>) > > Inférieur à (<) < < - 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 :