Présentation des messages Transaction

Les messages Transaction envoient à Google des données sur les chambres, les prix et les formules. Il existe deux principaux types de messages Transaction :

  • Données sur le séjour : définissent l'offre de chambres et les données concernant le séjour, y compris celles indiquées ci-dessous :

    • Prix et inventaire de l'hôtel : définit le prix minimal d'un séjour répondant à certaines conditions. Pour en savoir plus, consultez la section Mettre à jour des prix. Vous pouvez également supprimer une chambre de votre inventaire. Pour en savoir plus, consultez la section Supprimer des éléments de l'inventaire.
    • Offres de chambres : spécifient les tarifs d'un séjour correspondant à la combinaison d'une chambre physique et d'un ensemble de services supplémentaires. Pour en savoir plus, consultez la section Offres de chambres.

    Google met en cache le contenu de vos messages Transaction pour que les prix soient disponibles à tout moment. Dans certains cas, Google découvre que les valeurs contenues dans le cache ne sont pas à jour, et peut alors envoyer des messages <Query> supplémentaires (ou, dans certains cas, des requêtes de prix en temps réel) pour obtenir les prix actualisés.

    En règle générale, ces données changent très fréquemment. Pour définir des messages Transaction sur les tarifs et les disponibilités, utilisez <Result>.

  • Métadonnées de chambres et de formules : contiennent des informations sur les chambres et les formules (par exemple, descriptions, photos et occupation maximale). Ces données ne changent pas très souvent. Pour définir des messages Transaction de métadonnées, utilisez <PropertyDataSet>.

    Google stocke ces métadonnées pour que vous puissiez y faire référence dans vos messages sur les tarifs au lieu d'inclure à chaque fois des informations répétitives sur les chambres et les formules. Pour en savoir plus, consultez la section Définir des métadonnées de chambres et de formules.

L'élément racine d'un message Transaction est <Transaction>.

Les messages qui utilisent l'élément <Transaction> comme élément racine doivent comporter au moins l'un des éléments enfants.

Les messages Transaction peuvent comporter autant d'éléments enfants que nécessaire, tant que la taille totale du message ne dépasse pas 100 Mo.

Vous trouverez des exemples de messages Transaction répondant aux requêtes de Google dans la documentation de référence XML sur les tarifs et l'inventaire des chambres (transactions).

Modes d'envoi

Le type des messages Transaction et la fréquence à laquelle vous devez les envoyer dépendent du mode d'envoi utilisé :

  • Avec le mode d'envoi Pull, vous envoyez des messages Transaction lorsque vous recevez un message <Query> de la part de Google.
  • Avec le mode d'envoi Requête de prix modifiés, vous envoyez un message Transaction après avoir reçu et répondu à un message <HintRequest> et <Query>.

Pour en savoir plus, consultez la section Choisir un mode d'envoi.

Requêtes de prix en temps réel

Quel que soit le mode d'envoi utilisé, Google est également susceptible de vous envoyer des requêtes appelées requêtes de prix en temps réel. Ces messages Query demandent des prix qui répondent à une recherche en cours. Si vous répondez dans les délais impartis (soit, généralement, en quelques centaines de millisecondes), votre annonce peut apparaître dans l'enchère. Vos résultats peuvent également mieux correspondre au client, par exemple à son pays, à son type d'appareil et au nombre de clients spécifié. Pour en savoir plus, consultez la section Requêtes de prix en temps réel.

Taille des messages

Un même message Transaction peut inclure plusieurs mises à jour de données, mais sa taille ne doit pas dépasser 100 Mo. En règle générale, toutes les requêtes Pull et Hint request doivent répondre dans un délai de 100 secondes. Le délai avant expiration est un champ configurable que Google peut modifier sur demande. Google recommande de définir un délai d'expiration de 10 minutes pour les messages très volumineux.

Pour réduire considérablement la taille des messages, et éviter des erreurs causées par la taille des messages et les délais d'expiration, utilisez des messages Transaction pour prédéfinir vos métadonnées de chambres et de formules. Vous pouvez également ajouter du contenu GNU compressé aux messages en ajoutant Content-Encoding: gzip aux en-têtes de messages.