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:

  1. Données relatives au séjour: définissez les données concernant les offres de chambres et les itinéraires, y compris les éléments suivants:

    • Prix et inventaire de l'hôtel: définissez le prix minimal d'un séjour répondant à certaines exigences. Pour en savoir plus, consultez la section Mettre à jour les prix. Vous pouvez également supprimer une pièce de l'inventaire. Pour en savoir plus, consultez la section Supprimer l'inventaire.

    • Offres de chambres: définissez le prix d'un séjour pour une chambre physique et un ensemble de services supplémentaires. Pour en savoir plus, consultez 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étermine que les valeurs dans son cache ne sont pas à jour. Il peut donc envoyer des messages <Query> supplémentaires (ou, dans certains cas, des requêtes de prix en temps réel) pour obtenir les prix mis à jour. Ces données changent généralement très fréquemment. Pour définir la tarification et la disponibilité des messages Transaction, utilisez <Result>.

  2. Métadonnées des chambres et des formules: spécifie les détails des chambres et des formules, tels que la description, les photos et le nombre maximal de personnes. 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 afin que vous puissiez vous y référer depuis vos messages sur les tarifs au lieu d'inclure des informations répétitives sur les chambres et les formules. Pour en savoir plus, consultez 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 un nombre illimité d'éléments enfants, à condition que la taille totale du message ne dépasse pas 100 Mo.

Pour obtenir des exemples de messages Transaction qui répondent à des requêtes de Google, consultez la documentation de référence XML sur les tarifs et l'inventaire des chambres (transactions).

Modes de distribution

Le type et la fréquence à lesquels vous envoyez des messages Transaction dépendent du mode d'envoi utilisé:

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

Pour en savoir plus, consultez Tarification des modes d'envoi.

Requêtes de prix en temps réel

Quel que soit le mode d'envoi, Google peut également vous envoyer des requêtes appelées requêtes de prix en temps réel. Ces messages de requête recherchent des prix en réponse à une recherche en cours. Si vous répondez dans le délai indiqué (généralement de quelques centaines de millisecondes), votre annonce peut apparaître dans l'enchère. Vos résultats peuvent également mieux correspondre au client, y compris son pays et son type d'appareil, et le nombre d'invités qu'il a spécifiés. Pour en savoir plus, consultez la section Requêtes de requête de prix en temps réel.

Taille du message

Vous pouvez inclure n'importe quelle combinaison de mises à jour de données dans un seul message Transaction, mais la taille de chaque message est limitée à 100 Mo. En règle générale, le délai de réponse de toutes les requêtes d'extraction et d'indication est de 100 secondes. Le délai avant expiration est un champ configurable que Google peut ajuster à la demande. Google vous recommande de définir un délai d'inactivité de 10 minutes pour les messages très volumineux.

Pour réduire considérablement la taille des messages et, éventuellement, éviter les problèmes liés à leur taille et aux délais avant expiration, utilisez des messages Transaction pour prédéfinir les métadonnées des chambres et des séjours organisés. Vous pouvez également ajouter du contenu ZIP GNU aux messages en ajoutant Content-Encoding: gzip aux en-têtes de message.