Une liste d'hôtels est un ou plusieurs fichiers XML qui répertorient tous les hôtels pour lesquels vous fournirez des informations tarifaires. Le fichier de liste d'hôtels ne contient pas d'informations sur les tarifs.
L'élément racine d'une liste d'hôtels est l'élément <listings>. Cet élément contient des éléments <listing> décrivant vos propriétés.
Vous créez une liste d'hôtels dans le cadre de votre mise en œuvre initiale, puis vous en ajoutez ou en supprimez dans le cadre d'une 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 être éligible à Google Hotel Ads, un établissement de votre liste d'hôtels doit remplir les critères suivants:
- Disposer de chambres où les clients peuvent séjourner
- Avoir une présence physique et un emplacement fixe ouvert au public
- Murs fixes et plomberie
- Ne pas imposer une durée minimale de séjour supérieure à sept 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 dotés de murs fixes, de plomberie et de climatiseur (y compris les poêles à bois ou les radiateurs au propane) sont éligibles. Voici quelques exemples d'hébergements en extérieur non éligibles:
- Emplacements pour tentes
- Terrains pour camping-cars où les clients peuvent apporter leur propre camping-car
<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 la liste d'hôtels:
+<listings>+ <language> + <datum> +<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> <datum>datum_code </datum> <listing>listing</listing> ... </listings>
Attributs
L'élément <listings> possède les attributs suivants :
| Attribute | nécessaire | Description |
|---|---|---|
xmlns:xsi |
Obligatoire | Définissez la valeur sur "http://www.w3.org/2001/XMLSchema-instance". |
xsi:noNamespaceSchemaLocation |
Obligatoire | Définissez la valeur sur "http://www.gstatic.com/localfeed/local_feed.xsd". |
Éléments enfants
L'élément <listings> comporte les éléments enfants suivants :
| Élément enfant | Obligatoire ? | Type | Description |
|---|---|---|---|
<language> |
Obligatoire | Chaîne | Langue dans laquelle votre flux est rédigé. Définissez la valeur de cet élément sur un code de langue à deux lettres. Par exemple, "en" pour l'anglais. |
<datum> |
Optional | Enum | Cet élément spécifie la données géodésiques, ou modèle de référence pour les coordonnées de latitude/longitude fournies dans le flux. Si aucune valeur de référence n'est fournie, la valeur par défaut de cet élément est WGS84, qui est utilisée par la plupart des appareils GPS modernes. Le plan de référence de Tokyo ne s'applique qu'aux adresses au Japon.
Les valeurs valides pour cet élément sont les suivantes:
|
<listing> |
Obligatoire | <listing> |
Une ou plusieurs entrées décrivant chaque hôtel du flux. Notez que chaque hôtel de la liste doit être associé à un identifiant unique à votre site, et que cet identifiant 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>GB</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 au format libre
L'exemple suivant présente une liste d'hôtels partielle avec une adresse au format 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'un hôtel dans un élément de liste d'hôtels <listings>.
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 | Obligatoire ? | Type | Description |
|---|---|---|---|
<id> |
Obligatoire | Chaîne | Identifiant unique de l'hôtel. |
<name> |
Obligatoire | Chaîne | Nom de l'hôtel. Exemple :
<name>Belgrave House</name> |
<address> |
Obligatoire | Objet ou chaîne | Situation géographique complète 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
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 au format libre, bien que cela ne soit pas recommandé. Exemple : <address>666 Acacia Ave, Floor 5, Boston, MA, 02472</address> Notez que les boîtes postales et les autres adresses postales uniquement ne sont pas considérées comme des adresses physiques à part entière. |
<country> |
Obligatoire | Chaîne | Pays dans lequel se trouve cette fiche. La valeur indiquée doit être un code pays à deux lettres majuscules ISO 3116.
Exemples : "US" pour les États-Unis ou "CA" pour le Canada. Exemple :
<country>US</country> |
<latitude> |
Obligatoire* | Nombre à virgule flottante | Latitude de l'emplacement de l'hôtel. Par exemple : <latitude>37.423738</latitude> Cette valeur peut être générée à l'aide d'outils de géocodage tels que l'API Google Maps. |
<longitude> |
Obligatoire* | Nombre à virgule flottante | Longitude de l'emplacement de l'hôtel. Par exemple : <longitude>-122.090101</longitude> Cette valeur peut être générée à l'aide d'outils de géocodage tels que l'API Google Maps. |
<location_precision> |
Optional | Integer | Précision de l'emplacement de la propriété envoyée en mètres lorsque la latitude et la longitude de la propriété sont obscurcies. La valeur zéro (0) signifie qu'il n'y a pas d'obscurcissement ni d'emplacement exact. 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 à l'agence (et non celui du siège social). L'attribut
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 moins fournir un type |
| * Vous devez indiquer un numéro de téléphone OU des coordonnées de latitude/longitude. Nous vous recommandons de définir les deux. | |||
<category> |
Optional | Chaîne | Type d'établissement (hôtel, par exemple). Les partenaires peuvent utiliser n'importe quelle catégorie interne pour décrire leur établissement, comme "hôtels d'affaires", "complexes hôteliers", "motels" et autres. |
<content> |
Optional | <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>GB</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 au format libre
L'exemple suivant présente une liste d'hôtels partielle avec une adresse au format 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 | Obligatoire ? | Type | Description |
|---|---|---|---|
<text |
Facultative | Objet | Page Web associée à la fiche du fournisseur. associé aux éléments enfants suivants :
Remarque : Ces éléments doivent apparaître dans l'ordre ci-dessus. |
<review |
Facultative | <review> |
Contient un avis d'utilisateur ou de journaliste sur la fiche. Votre fiche peut contenir un nombre illimité d'avis, quel que soit leur type. Vous n'avez pas besoin d'inclure tous les avis sur un établissement dans votre élément |
<attributes> |
Facultative | Objet | Contient 0 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 Tous les éléments S'il existe un élément enfant |
<image> |
Facultative | 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. Vous n'avez pas besoin d'inclure tous les avis sur une fiche dans votre élément <listing>. Cet élément est destiné à inclure des avis sélectionnés qui reflètent les caractéristiques ou la qualité de la fiche.
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> possède les attributs suivants :
| Attribute | nécessaire | Description |
|---|---|---|
type |
Obligatoire | Type d'examen. Définissez l'une des valeurs suivantes :
|
Éléments enfants
L'élément <review> comporte les éléments enfants suivants :
| Élément enfant | Obligatoire ? | Type | Description |
|---|---|---|---|
<link> |
Facultative | Chaîne | Lien vers l'avis. Incluez "http://" ou "https://" dans cet élément. |
<title> |
Facultative | Chaîne | (Avis de journalistes uniquement) Titre de l'avis. |
<author> |
Facultative | 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 dans lesquels l'avis apparaît s'il n'est pas crédité. |
<rating> |
Facultative | Chaîne | Nombre à virgule flottante compris entre 0 et 10 (inclus) représentant la note de l'avis. Exemple : "8.9". |
<body> |
Facultative | Chaîne | Texte de l'avis. Cet élément ne doit pas contenir de code HTML. |
<date month="MM" day="DD" year="YYYY"/> |
Facultative | 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"/> |
Facultative | 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 la propriété type de l'avis est editorial et que <date> n'est valide que si type est user.
Exemple
L'exemple suivant présente une liste d'hôtels partielle avec une fiche contenant un éditorial et l'avis d'un 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>
La balise <attributes> permet de décrire les services proposés, et de classer les notes et les avis sur l'établissement.
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
+ <attributes>
Remarque : Tous les attributs sont facultatifs.
Éléments enfants
| Élément enfant | Obligatoire ? | Description | |
|---|---|---|---|
<website> |
Facultative | Site Web principal de l'hôtel. S'il est présent, il doit être positionné avant le premier élément <client_attr>. Exemple :
<website>https://hotel.example.com</website> |
|
<client_attr name="attribute_name"> |
Facultative | Caractéristique supplémentaire ou "attribut" de l'établissement pouvant être spécifié à l'aide d'une valeur attribute_name actuellement acceptée ou d'une propriété 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 une chambre, mais tous les aliments 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 être utile d'utiliser des identifiants distincts si vous avez besoin d'un identifiant de propriété pour vos informations de flux et d'un autre identifiant de propriété pour votre moteur de réservation. | N'importe quelle valeur de chaîne |
child_friendly |
L'entreprise propose une ou plusieurs caractéristiques spéciales pour les familles voyageant avec des enfants, telles que des tarifs réduits, des lits pour enfants ou des lits pour enfants, un club 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 pourront pas les voir. | N'importe quelle valeur de chaîne |
has_affiliated_golf_course |
Cet établissement possède un parcours de golf sur site ou possède un parcours de golf à proximité. Il propose des réservations de départ et un service de transport pour les clients depuis et vers le parcours de golf. L'utilisation du parcours de golf est souvent payante. | Oui/Non |
has_airport_shuttle |
Un service de navette aéroport est proposé sans frais ou moyennant un supplément. Il peut s'agir d'une navette qui s'arrête dans plusieurs hôtels, à condition qu'il existe un arrêt explicite pour cet hôtel. | Oui/Non |
has_bar_or_lounge |
L'établissement possède un bar lounge intérieur et/ou extérieur servant des boissons alcoolisées. Les clients n'ont pas besoin de quitter l'établissement pour accéder au bar ou au salon. | 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 un ordinateur, un accès Internet et une imprimante. | 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 jours 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 gratuit et un prix de chambre qui n'inclut pas le petit-déjeuner gratuit, vous devez indiquer false pour cet attribut. |
Oui/Non |
has_hot_tub |
Une partie ou l'ensemble des chambres sont pourvues d'un bain à remous, 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 à la réception ou dans leur chambre pour que leurs vêtements soient lavés. Des frais supplémentaires peuvent s'appliquer pour le service. La laverie libre-service ne compte pas. | 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 livré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 offerts ou payants suivants: massages, sauna et soins du visage. Les clients n'ont pas besoin de quitter l'établissement pour accéder au spa. | Oui/Non |
hotel_brand |
Marque de l'hôtel. Par exemple, "Marriott" ou "Hilton". Les utilisateurs ne pourront pas le voir, mais ils pourront être utilisés pour regrouper des hôtels. | N'importe quelle valeur de chaîne |
kitchen_availability |
Les clients peuvent préparer des repas chauds et réfrigérer la nourriture dans leur chambre. |
|
lodging |
Représentation codée de tous les champs disponibles dans le proto Lodging. |
Chaîne encodée en base64 du protocole Lodging encodé |
number_of_rooms |
Ce champ indique le nombre total d'unités associées à l'ID de 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 nombre entier non négatif. |
num_reviews |
Nombre d'avis associés à la fiche. | Tout nombre entier non négatif. |
parking_type |
Indique si un parking est disponible, et s'il est offert ou payant. |
|
pets_allowed |
Tout ou partie des chambres permettent aux clients d'amener des animaux de compagnie (chiens et/ou chats qui ne sont pas des 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 classification. |
smoke_free_property |
Il est interdit de fumer dans 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 (Wi-Fi) aux clients dans toutes les parties de l'établissement (pas uniquement dans une zone spécifique). Ce service peut être offert ou payant. |
|
Valeurs de l'espace réservé "attribute_name" pour les locations de vacances
Consultez Attributs spécifiques aux locations de vacances et exemple XML.
<image>
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
+ <attributes>
+ <image>
Les images permettent d'afficher la propriété 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 contient 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
- Allow: /
- Permet au robot d'exploration Googlebot d'explorer les images de votre site.
- User-agent: Googlebot-Image
- Allow: /
- Les captures d'écran d'images ou de sites Web ne sont pas autorisées. Les images doivent être des images ou des photos originales.
Attributs
| Nom de l'attribut | Obligatoire ? | Format | Description |
|---|---|---|---|
type |
Obligatoire | Texte | Vous devez utiliser l'une des images suivantes:
|
url |
Obligatoire | Texte | URL de l'image en taille réelle. Utilisez l'attribut url pour spécifier l'image à utiliser sur cette page. |
width |
Obligatoire | Entier non négatif | Largeur de l'image en pixels (plus de 720 pixels recommandé) |
height |
Obligatoire | Entier non négatif | Hauteur de l'image, en pixels (supérieure à 720 pixels recommandée) |
Éléments enfants
| Élément enfant | Obligatoire ? | Description |
|---|---|---|
<link> |
Demandé, mais obligatoire pour les fiches de photos locales. | Cette balise contient l'URL valide et à jour de la page de votre site sur laquelle se trouve l'image concernée. Il ne contient pas l'URL de l'image elle-même.
Exemple:<link><http://www.example.com/magic_pizza/></link> |
<title> |
Demandé | Cette balise contient le titre de l'image. Exemple: <title>"Luxury Apartment"</title> |
<author> |
Non obligatoire | 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 | Cette balise identifie la date de création de l'élément de contenu. Vous devez saisir une année, un mois et un jour, comme dans l'exemple suivant: <date month="6" day="7" year="2017"/> |
Exemple
L'exemple suivant présente une liste d'hôtels partielle avec des tags d'image:
<?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
Pour créer une liste d'hôtels basée sur XML, suivez les consignes ci-dessous:
- Validez vos fichiers XML de votre 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 à l'aide de 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 utiliser le code d'entité ou le code de 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 Esperluette (&) & & Guillemet simple (') ' ' Guillemet double (") " " Supérieur à (>) > > Inférieur à (<) < < - Omettez les éléments XML qui ne contiennent pas de données. Par exemple, si vous ne connaissez pas la latitude et la longitude d'un hôtel, vous ne devez pas inclure d'é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 de l'importer, vous pouvez utiliser le flux local XSD "http://www.gstatic.com/localfeed/local_feed.xsd".
- Pour utiliser des commentaires dans votre flux, entourez-les des tags
<!--et-->, comme dans l'exemple suivant:<!-- This is a comment -->
- Veillez à fermer l'élément
<date>dans un utilisateur<review>. Exemple :<date day="2" month="12" year="2017"/>
Identifier et corriger les problèmes de données
Pour rechercher et résoudre les problèmes de données dans votre liste d'hôtels, vous pouvez utiliser les outils suivants:
Hotel Center :