Présentation des flux ARI

La disponibilité, les tarifs et l'inventaire (ARI) sont un mode d'envoi des prix qui contrôle les tarifs par nuit, la disponibilité et l'inventaire, et fournit des contraintes sur la manière dont ils peuvent être combinés. Les ARI permettent également d'inclure des taxes, des frais et des promotions.

Contrairement aux modes d'envoi des prix basés sur les séjours, les flux "Pull" et "Requête de prix modifiés", les flux ARI ne sont pas interrogés pour des prix ou des séjours spécifiques. Vous transmettez plutôt des messages lorsque votre modèle de tarification comporte des données nouvelles ou modifiées, telles que des modifications apportées aux détails des tarifs, aux restrictions et à la disponibilité.

Avantages

ARI offre les avantages suivants:

  • Efficacité de la bande passante: accroît l'efficacité de la bande passante en réduisant le volume de données à transmettre. En envoyant des données ARI par nuit et uniquement des modifications incrémentielles, Google peut calculer les prix et les mises à jour pour un large éventail de valeurs d'achat à l'avance et de durée du séjour.

  • Précision des prix: améliore la précision des prix en utilisant un modèle d'événement "push-change" (modification push) pour fournir des informations en direct.

  • Couverture des prix plus importante: pour obtenir une couverture des prix plus élevée (nombre de séjours avec les prix), utilisez des données précises combinées à plusieurs itinéraires.

  • Flexibilité: offre plus de flexibilité grâce à la promotion et aux packages.

  • Simplicité d'utilisation: la transmission des données est effectuée conformément à la manière dont elles sont stockées sur votre système, ce qui vous évite de calculer ou de mettre en cache les prix pour de nombreux séjours.

Types de messages de demande

Les messages ARI envoyés à Google sont appelés messages de "demande" ARI. Google renvoie ensuite les messages de "réponse" indiquant la réussite ou l'échec.

ARI suit les protocoles standards de OpenTravel Alliance (OTA) pour certains des principaux types de messages permettant de définir la disponibilité et l'inventaire.

ARI utilise les messages de requête suivants:

  • Transaction (Données sur la propriété). Définit les informations sur le type de chambre et le forfait (plan tarifaire).

  • OTA_HotelRateAmountNotifRQ : définit les montants du tarif d'occupation par date ou par durée de séjour par produit (combinaison de type de chambre et de plan tarifaire) pour des plages de dates spécifiques.

  • OTA_HotelAvailNotifRQ, qui définit la disponibilité et les restrictions en fonction du type de chambre et des plans tarifaires. Vous pouvez également mettre à jour l'inventaire à l'aide de ce message, mais il est préférable d'utiliser OTA_HotelInvCountNotifRQ.

  • OTA_HotelInvCountNotifRQ : définit l'inventaire des chambres physiques ou le nombre de chambres disponibles à la vente.

  • TaxFeeInfo (facultatif) : définit les taxes et les frais par établissement. Ce message n'est pas obligatoire si AmountAfterTax est spécifié dans le message OTA_HotelRateAmountNotifRQ.

  • Promotions (facultatif) : définit des tarifs promotionnels pour certaines réservations, certains séjours et certains utilisateurs.

  • RateModifications (facultatif) : définit des règles de modification des tarifs pour certaines réservations, certains séjours et certains utilisateurs.

  • ExtraGuestCharges (facultatif) : définit la manière dont les tarifs doivent être configurés pour les enfants et les adultes supplémentaires.

Chaque message contient un sous-ensemble d'informations que Google utilise pour calculer les prix et la disponibilité affichés aux utilisateurs lorsqu'ils recherchent vos établissements avec des dates d'arrivée et de départ spécifiques, et le nombre de personnes souhaité.

Pour en savoir plus sur ARI, consultez la documentation de référence XML.

Messages push

Pour mettre à jour les informations ARI et de la propriété, envoyez les messages associés chaque fois que les données changent dans votre système.

Suivez les consignes ci-dessous lorsque vous envoyez des messages:

  • Utilisez l'outil en libre-service sur la page des paramètres de prix Hotel Center pour ajouter ou mettre à jour vos adresses IP dans notre système.

  • Utilisez le chemin de base suivant pour le point de terminaison:

    • https://www.google.com ou Host: www.google.com Port: 443

  • Envoyez des messages avec la méthode HTTP POST.

  • définir l'en-tête Content-Type sur application/xml ;

  • Le taux de mise à jour maximal au niveau du compte est de 400 messages par seconde. Si vous dépassez cette limite, un code d'erreur 6032 est renvoyé.

  • Utilisez les chemins suivants en fonction des données mises à jour:

    • Transaction (données de la propriété): /travel/hotels/uploads/property_data
    • OTA_HotelRateAmountNotifRQ : /travel/hotels/uploads/ota/hotel_rate_amount_notif
    • OTA_HotelAvailNotifRQ : /travel/hotels/uploads/ota/hotel_avail_notif
    • OTA_HotelInvCountNotifRQ : /travel/hotels/uploads/ota/hotel_inv_count_notif
    • TaxFeeInfo : /travel/hotels/uploads/taxes
    • Promotions : /travel/hotels/uploads/promotions
    • RateModifications : /travel/hotels/uploads/rate_modifications
    • ExtraGuestCharges : /travel/hotels/uploads/extra_guest_charges

Pour chaque message de requête reçu, Google renvoie une réponse HTTP 200 OK si la connexion au serveur a abouti, et inclut un corps de message de réponse indiquant si les mises à jour ont bien été appliquées ou si des avertissements ou des erreurs ont été rencontrés. Si Google répond par un code d'erreur HTTP, renvoyez le message. Si le corps de la réponse HTTP contient des avertissements ou des erreurs, vous devez les corriger avant de renvoyer le message. Vous pouvez également consulter les problèmes rencontrés pour des messages spécifiques sur la page "État du flux" dans Hotel Center.

Actuellement sur Google (LoG)

En ligne sur Google (LoG) vous permet d'afficher vos hôtels sur les sites Web de Google. La valeur LoG par défaut d'un hôtel étant true, tous les nouveaux hôtels sont automatiquement affichés sur Google.

Utilisez LoG pour activer ou désactiver vos établissements pour les annonces et les liens de réservation gratuits dans votre compte Hotel Center, quel que soit l'état de Google Ads ou si les tarifs de l'établissement sont définis sur Google. Cela ne s'applique qu'aux hôtels et non aux locations de vacances.

Il existe deux façons de définir la valeur LoG d'un hôtel: Travel Partner API or the Hotel Center properties page. You can change the status of your existing properties in the Live on Google column on the Hotel Center properties page, or if you want to change the status of a large number of properties at the same time, you can use the Travel Partner API.

Pour en savoir plus sur LoG, consultez l'aide Hotel Center.

Avec le Travel Partner API, you can do the following:

  • Affichez l'état de vos établissements via Hotel Center ou utilisez le point de terminaison hotelViews.list.

  • Récupérez la liste de tous les hôtels affichés sur Google à l'aide du paramètre filter avec liveOnGoogle = TRUE dans le point de terminaison hotelViews.list.

  • Obtenez un récapitulatif des propriétés d'un compte spécifique, y compris le nombre d'établissements actifs sur Google en utilisant hotelViews.summary.

Pour en savoir plus sur la définition de LoG à l'aide de l'API, consultez l'article hotelViews.list et la documentation de référence de l'API.