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 aux horaires demandés. Pour découvrir d'autres méthodes de configuration d'une liste d'hôtels, consultez la section 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 le géocode de l'établissement) organisées par établissement pour tous les établissements d'un compte Hotel Center.

Vous trouverez ci-dessous un exemple très basique de fichier de liste d'hôtels au format XML. Cet exemple n'affiche qu'un seul des différents éléments <listing> spécifiés dans le fichier. Chaque élément <listing> représente une propriété.

<?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 relatives aux fichiers.

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

  3. Validez les fichiers à l'aide du schéma de 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

Le mode d'envoi "Pull" pour la liste d'hôtels vous permet d'héberger une liste d'hôtels sur votre serveur. Google récupère alors le flux à la fréquence de votre choix. Une fois que vous avez créé votre liste d'hôtels 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 conditions requises pour l'authentification

Si aucune erreur ne s'affiche, votre liste d'hôtels est publiée et tous les établissements pour lesquels une correspondance est établie dans Google Maps s'affichent dans votre compte Hotel Center, dans l'onglet "Établissements".

En cas d'erreurs, Google les partage avec vous afin que vous puissiez les corriger et préparer à nouveau les fichiers pour le téléchargement.

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 extrait par Google, c'est-à-dire n'utilisez pas le répertoire download.

  • Une fois que vous avez validé les fichiers XML de votre flux, créez un lien symbolique depuis 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 mis en forme comme un fichier Microsoft Word.

  • Assurez-vous que la taille du fichier XML non compressé ne dépasse pas 100 Mo. Un ou plusieurs fichiers XML peuvent être compressés dans un seul fichier .zip. Le nombre de fichiers XML compressés et les fichiers .zip n'est pas limité.

  • 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 n'importe quelle manière. 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 accepté.