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 l'itinéraire, dont 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 la section Mettre à jour des prix. Vous pouvez également supprimer une chambre de l'inventaire. Pour en savoir plus, consultez la section Supprimer un inventaire.
Offres de chambres: définissez le prix d'un séjour pour 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étermine que les valeurs contenues 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 à jour. En général, ces données changent très fréquemment. Pour définir les prix et la disponibilité des messages Transaction, utilisez<Result>.
Métadonnées de chambres et de formules: spécifient les informations sur les chambres et les formules, telles que les descriptions, les photos et le nombre de personnes maximal. 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 à partir de 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 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 plusieurs éléments enfants, mais la taille totale des messages ne doit pas dépasser 100 Mo.
Pour obtenir des exemples de messages Transaction répondant aux 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 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 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 des messages
<HintRequest>et<Query>, et y avoir répondu.
Pour en savoir plus, consultez la section Modes d'envoi des tarifs.
Requêtes de prix en temps réel
Quel que soit le mode d'envoi utilisé, Google peut également vous envoyer des requêtes appelées requêtes de prix en temps réel. Ces messages de demande 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 le nombre de clients 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 n'importe quelle combinaison de 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 requêtes d'extraction et d'indication ont un temps de réponse limité à 100 secondes. Le délai avant expiration est un champ configurable que Google peut modifier sur 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 potentiellement des 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 de message.