Présentation de l'ARI

ARI (Availability, Rates, and Inventory, c'est-à-dire "Disponibilité, Tarifs et Inventaire") est un mode d'envoi des prix qui contrôle les tarifs par nuit, la disponibilité et l'inventaire, et qui fournit des contraintes sur la façon dont ils peuvent être combinés. L'ARI permet également d'inclure les taxes, les frais et les promotions.

Contrairement aux modes d'envoi des prix basés sur les séjours (Pull et Requête de prix modifiés), les flux ARI ne reçoivent pas de requêtes portant sur des séjours ou des prix spécifiques. À la place, vous envoyez des messages lorsque votre modèle de tarification comporte des données nouvelles ou modifiées, par exemple des modifications des tarifs, des restrictions et de la disponibilité.

Avantages

L'ARI offre les avantages suivants :

  • Efficacité de la bande passante : augmente l'efficacité de la bande passante en réduisant le volume de données à transmettre. En envoyant des données ARI chaque nuit et uniquement les modifications incrémentales, Google peut calculer les prix et les mises à jour pour un large éventail de valeurs d'achat anticipé 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-on-change pour fournir des mises à jour en direct.

  • Couverture tarifaire plus large : permet d'obtenir une couverture tarifaire plus élevée (nombre d'itinéraires avec des prix) en utilisant des données précises combinées dans différents itinéraires.

  • Flexibilité : offre une plus grande flexibilité pour proposer des promotions et des forfaits.

  • Facilité d'utilisation : transmet les données de manière conforme à la façon dont elles sont stockées sur votre système, ce qui évite d'avoir à calculer ou à mettre en cache les prix de nombreux itinéraires.

Types de messages de requête

Les messages ARI envoyés à Google sont exprimés comme des messages de "requête" ARI. Google renvoie ensuite des messages de "réponse" indiquant la réussite ou l'échec de l'opération.

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 un établissement) : Définit les informations sur le type de chambre et la formule (plan tarifaire).

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

  • OTA_HotelAvailNotifRQ. Définit la disponibilité et les restrictions en fonction du type de chambre et des plans tarifaires. L'inventaire peut également être mis à jour à l'aide de ce message, mais OTA_HotelInvCountNotifRQ est préférable.

  • 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 pour chaque é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 les règles de modification des tarifs pour certaines réservations, certains séjours et certains utilisateurs.

  • ExtraGuestCharges. (Facultatif) Définit la façon dont les tarifs doivent être configurés pour les enfants et les adultes supplémentaires.

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

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

Messages push

Pour mettre à jour les flux ARI et les informations sur les établissements, envoyez les messages associés à chaque modification des données dans votre système.

Pour envoyer des messages, suivez les consignes ci-dessous :

  • Utilisez l'outil en libre-service de la page 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 à l'aide de la méthode HTTP POST.

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

  • La fréquence maximale de mise à jour au niveau du compte est de 400 messages par seconde. Si vous dépassez cette limite, le code d'erreur 6032 est renvoyé.

  • Utilisez les chemins d'accès suivants, en fonction des données mises à jour :

    • Transaction (données sur un établissement) : /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 avec un message de réponse indiquant si les mises à jour ont été correctement appliquées, ou ont généré des avertissements ou des erreurs. 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, les problèmes doivent être corrigés avant que le message ne soit renvoyé. Vous pouvez également afficher les problèmes rencontrés pour des messages spécifiques sur la page "État du flux" dans Hotel Center.

En ligne sur Google (LoG)

Live on Google (LoG) vous permet d'afficher vos hôtels sur les sites Web de Google. Étant donné que la valeur LoG par défaut pour un hôtel est true, tous les nouveaux hôtels s'afficheront automatiquement sur Google.

Utilisez En ligne sur Google dans votre compte Hotel Center afin d'activer ou de désactiver les annonces et les liens de réservation gratuits pour vos établissements, quel que soit leur état dans Google Ads et que les tarifs de l'établissement aient été fournis à Google ou non.

Il existe deux façons de définir la valeur LoG d'un hôtel : l'élément 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 les FdR, consultez l'aide Hotel Center.

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

  • Pour connaître l'état de vos établissements, accédez à Hotel Center ou utilisez le point de terminaison hotelViews.list.

  • Récupérez la liste de tous vos hôtels affichés sur Google en utilisant le 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 de propriétés en ligne sur Google, à l'aide de hotelViews.summary.

Pour savoir comment définir le niveau d'enregistrement à l'aide de l'API, consultez l'article hotelViews.list et la documentation de référence de l'API.