Configurer une liste d'hôtels au format XML

Pour configurer votre liste d'hôtels, vous pouvez utiliser l'une des méthodes suivantes:

  • Fournir un fichier CSV ou XML
  • Importer un fichier depuis Hotel Center
  • Héberger un fichier sur un serveur

Ce guide explique comment configurer une liste d'hôtels à l'aide de fichiers XML et héberger le flux XML sur votre serveur pour que Google puisse télécharger vos fichiers XML selon les horaires indiqués. Pour découvrir d'autres méthodes de configuration d'une liste d'hôtels, consultez Configurer votre inventaire d'hôtels.

À propos des listes d'hôtels au format XML

Un fichier de liste d'hôtels contient des données descriptives (telles que le nom, l'adresse et l'emplacement géographique de l'établissement) organisées par établissement, pour tous les établissements d'un compte Hotel Center.

Vous trouverez ci-dessous un exemple très simple de fichier de liste d'hôtels au format XML. Cet exemple ne montre qu'un seul des nombreux éléments <listing> spécifiés dans le fichier. Chaque élément <listing> représente un établissement.

<?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">6 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>

Créer une liste d'hôtels au format XML

Pour créer un flux Hotel List Feed au format XML, procédez comme suit:

  1. Consultez les exigences concernant les fichiers.

  2. Codez vos fichiers comme décrit dans la documentation de référence XML pour les listes d'hôtels.

  3. Validez les fichiers à l'aide du schéma du flux Hotel List Feed.

Après avoir validé vos fichiers, hébergez le flux sur votre serveur. Vous pouvez également importer manuellement votre liste dans Hotel Center.

Héberger un flux XML sur votre serveur

Avec le mode d'envoi pull pour la liste d'hôtels, vous pouvez héberger une liste d'hôtels sur votre serveur. Google récupère ensuite le flux à la fréquence de votre choix. Une fois votre liste d'hôtels créée et validé ses fichiers XML, procédez comme suit:

  1. Préparez les fichiers pour Google comme décrit dans la section Conditions requises pour l'hébergement.

  2. Contactez votre responsable de compte technique (TAM) pour configurer les éléments suivants:

    • Un calendrier de téléchargement pour Google, généralement une fois par semaine
    • URL de téléchargement et exigences d'authentification

En l'absence d'erreurs, votre liste d'hôtels est publiée, et tous les établissements dont la correspondance a été établie dans Google Maps s'affichent dans l'onglet "Établissements" de votre compte Hotel Center.

Si des erreurs se produisent, Google les partage avec vous afin que vous puissiez les corriger et préparer les fichiers pour le téléchargement à nouveau.

Exigences liées à l'hébergement

Respectez les exigences suivantes lorsque vous hébergez votre flux XML:

Configuration requise pour le serveur

  • Le serveur doit être accessible via HTTP ou HTTPS.

Exigences concernant l'annuaire

Pour vous assurer que Google récupère un instantané complet de vos données et ne tente pas de télécharger des fichiers incomplets, suivez ces consignes lorsque vous publiez des fichiers sur votre serveur HTTP:

  • Développez et validez les fichiers XML de votre flux dans un répertoire autre que celui depuis lequel Google les récupère. Par exemple, n'utilisez pas le répertoire download.

  • Une fois les fichiers XML de votre flux validés, créez un lien symbolique dans le répertoire de téléchargement vers le nouveau flux.

  • Si vous fournissez un fichier .zip, incluez les fichiers XML au niveau racine et non dans le répertoire de téléchargement.

Conditions requises pour les fichiers

  • Utilisez des fichiers en texte brut et non un fichier formaté tel qu'un fichier Microsoft Word.

  • Assurez-vous que le fichier XML non compressé ne dépasse pas 100 Mo. Un ou plusieurs fichiers XML peuvent être compressés dans un seul fichier .zip. Il n'y a pas de limite pour les fichiers XML compressés ni pour les fichiers .zip.

  • Nommez les fichiers comme suit:

    • Pour un seul fichier XML, utilisez PARTNER_NAME_local.xml.
    • Pour un ou plusieurs fichiers XML dans un fichier ZIP, utilisez PARTNER_NAME_local.xml.zip.

    Les fichiers XML individuels du fichier ZIP peuvent être nommés de la manière suivante. Toutefois, nous vous recommandons d'ajouter un code de langue à chaque nom de fichier.

Conditions requises pour l'authentification

  • Vous pouvez éventuellement sécuriser vos fichiers avec un nom d'utilisateur et un mot de passe à l'aide de l'authentification BASIC ou DIGEST.

  • NTLM n'est pas compatible.