Mode d'envoi Push pour Hotel Prices

Remarque :Google prend en charge le transfert push pour un nombre limité de cas d'utilisation et de partenaires. Ce document est destiné aux partenaires existants qui utilisent actuellement le mode push et aux nouveaux partenaires qui respectent les consignes strictes de Google concernant l'utilisation de ce mode.

Si les limites du système vous interdisent d'accepter les modes d'envoi pull ou pull avec indications, veuillez utiliser le formulaire de contact.

Présentation du mode d'envoi push

Avec le mode d'envoi push, vous envoyez des mises à jour incrémentielles chaque fois que les prix ou la disponibilité changent.

L'image suivante illustre le flux requête/réponse pour le mode d'envoi push:

Remarque :Avant de pouvoir utiliser le mode push pour envoyer des mises à jour de prix à Google, vous devez ajouter les adresses IP de votre serveur à la liste blanche, comme décrit ci-dessous.

Configurer une commande push dans le fichier de configuration de protocole

Pour mettre à jour les prix avec le mode d'envoi push, spécifiez les éléments suivants dans votre fichier de configuration de protocole. Cette opération n'est possible que lorsque vous configurez pour la première fois votre environnement pour qu'il fonctionne avec l'API Hotel Prices:

• <Model>: définissez la valeur de l'élément <Model> sur "push".
• <WhitelistedIPs>: répertorie les adresses IP que vous utilisez pour authentifier la communication entre vous et Google. La valeur de cet élément peut être une liste de vos adresses IP séparées par un point-virgule, ou une plage d'adresses IP au format CIDR. Elle se présente sous la forme xxx.xxx.xxx.xxx/YY.

L'exemple suivant présente un fichier de configuration de protocole pour les partenaires utilisant le mode d'envoi Push:

<?xml version="1.0" encoding="UTF-8"?>
<Configuration>
  <Model>push</Model>
  <WhiteListedIPs>216.239.32.0/19;64.233.160.0/19</WhiteListedIPs>
</Configuration>

Pour en savoir plus, consultez Fichier de configuration de protocole.

Mettre à jour les prix avec Push

Pour mettre à jour vos données avec le mode push, envoyez un message Transaction chaque fois que vos données changent.

Suivez les consignes ci-dessous lorsque vous envoyez le message Transaction:

• Envoyez le message au point de terminaison suivant :
  • http://www.google.com/travel/hotels/uploads/price
• Utilisez la méthode POST HTTP.
• Définissez l'en-tête Content-Type sur "application/xml".
• Le corps du message doit respecter la syntaxe du message Transaction, comme décrit dans les sections Définir des prix (pour les mises à jour des prix) ou Définir des métadonnées de chambres et de formules (pour les mises à jour de métadonnées).
• Pour mettre à jour les prix, définissez un élément <Result> pour chaque séjour que vous souhaitez mettre à jour. Pour les mises à jour de métadonnées, définissez les données sur les chambres et les séjours organisés pour chaque établissement concerné.

Pour chaque message Transaction reçu, Google répond par un message HTTP 200 OK du serveur pour indiquer le succès de l'opération. Si Google répond par un code d'erreur HTTP, renvoyez le message Transaction. Si vous rencontrez des problèmes lors de l'envoi ou de la réception de messages, consultez la section Résoudre les problèmes liés aux flux.

Vous devez envoyer un message Transaction pour chaque séjour (combinaison d'un établissement, d'une date d'arrivée et d'une durée de séjour) dont le prix a changé. Vous pouvez envoyer jusqu'à cinq messages Transaction par seconde. Google ne bloquera pas les messages envoyés plus de cinq fois par seconde, mais votre message risque d'attendre la fin d'autres requêtes.

Pour réduire le trafic réseau, vous pouvez combiner plusieurs éléments <Result> dans un seul message Transaction.

Google traite généralement les prix mis à jour et les données de disponibilité en cinq minutes environ. Les prix seront supprimés au bout de 90 jours.

Pour en savoir plus sur l'utilisation des messages Transaction pour mettre à jour les prix, consultez la section Définir des prix.

Mettre à jour les métadonnées des chambres et des séjours organisés avec le mode d'envoi push

Pour mettre à jour les métadonnées de chambres et de formules, envoyez-les comme vous le feriez pour n'importe quelle autre mise à jour. Dans ce cas, vous envoyez un message Transaction contenant les nouvelles informations dans les éléments <RoomData> et <PackageData>. Ces éléments sont des enfants de l'élément <PropertyDataSet>.

Pour en savoir plus, consultez Définir des métadonnées de chambres et de formules.

Erreurs liées au mode d'envoi

Si vous recevez une erreur HTTP lors de l'envoi d'un message Transaction à Google, relancez la requête à 1, 5 et 20 minutes. Si le problème persiste après trois tentatives, arrêtez d'envoyer des messages et contactez votre responsable de compte Google.

Lorsque vous contactez votre responsable de compte Google pour signaler l'erreur HTTP que vous avez reçue lors de l'envoi d'un message Transaction, Google effectue des tests pour environ 10 hôtels tout en vérifiant que vos flux sont correctement configurés. Si les tests sont concluants, Google explore l'ensemble des hôtels définis dans votre flux Prix de l'hôtel. Cela garantit que les chargements sont acceptables et que vos prix restent exacts pendant trois à cinq jours. Ensuite, Google vous informe du lancement. Vous pouvez alors vous référer aux résultats en ligne.

À quelle fréquence les prix doivent-ils être envoyés ?

Idéalement, vous déployez toutes les mises à jour dès que vous savez qu'un prix a changé. Si vous ne savez pas quand les prix ont changé, essayez de maintenir les prix à jour le plus souvent possible. Cela inclut généralement plusieurs transferts par jour. En règle générale, les séjours du jour et de la semaine actuels sont transmis beaucoup plus fréquemment.