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 l'itinéraire: définissent l'offre de chambres et les données sur l'itinéraire, y compris les suivantes:
Prix et inventaire de l'hôtel: définissez le prix minimal d'un séjour répondant à certaines conditions. Pour en savoir plus, consultez Mettre à jour des prix. Vous pouvez également supprimer une salle de l'inventaire. Pour en savoir plus, consultez Supprimer l'inventaire.
Offres de chambres: définissent le prix d'un séjour pour une combinaison de chambre physique et 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étermine que les valeurs de 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 des prix actualisés. Ces données changent généralement très fréquemment. Pour définir la tarification et la disponibilité des messages Transaction, utilisez<Result>.
Métadonnées des chambres et des formules: spécifie les informations sur les chambres et les formules, telles que les descriptions, 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 pour que vous puissiez vous y référer dans vos messages de tarification au lieu d'inclure des informations répétitives sur les chambres et les formules dans chacun d'eux. Pour en savoir plus, consultez Définir les 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 nécessitent au moins l'un des éléments enfants. Les messages Transaction peuvent comporter un nombre illimité d'éléments enfants, à condition que leur taille totale ne dépasse pas 100 Mo.
Pour obtenir des exemples de messages Transaction répondant à des requêtes de Google, consultez la documentation de référence XML sur la tarification et l'inventaire des chambres (transactions).
Modes de distribution
Le type et la fréquence d'envoi des messages Transaction dépendent du mode d'envoi:
- Avec le mode d'envoi pull, vous envoyez des messages Transaction lorsque vous recevez un
<Query>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 aux requêtes
<HintRequest>et<Query>.
Pour en savoir plus, consultez la section Tarifs des modes d'envoi.
Requêtes de prix en temps réel
Quel que soit votre 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 spécifié, qui est 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, à son type d'appareil et au nombre de personnes qu'il a spécifié. Pour en savoir plus, consultez la section Requêtes de prix en temps réel.
Taille du message
Vous pouvez inclure plusieurs mises à jour de données dans un même message Transaction, mais la taille de chaque message est limitée à 100 Mo. En règle générale, toutes les demandes d'extraction et d'indication ont un délai de réponse de 100 secondes. Le délai avant expiration est un champ configurable que Google peut modifier à la demande. Google vous recommande de définir ce délai sur 10 minutes pour les messages très volumineux.
Pour réduire considérablement la taille des messages et éviter les problèmes liés à la taille des messages et aux 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 compressé GNU aux messages en ajoutant Content-Encoding: gzip aux en-têtes du message.