Les messages de requête sont des requêtes que Google vous envoie pour la mise à jour de vos tarifs et de vos métadonnées. Ils sont utilisés avec les modes d'envoi "Pull" et "Requête de prix modifiés" modes d'envoi.
L'élément racine des messages de requête est <Query>.
La structure du message de requête dépend du type de message :
Prix:nous envoyons un message de demande dans lequel nous exigeons la mise à jour des prix pour pour les hôtels spécifiés.
Métadonnées:Google envoie un message de demande qui demande des données sur la chambre. et les informations de séjour organisé dans les hôtels spécifiés.
Vous définissez le point de terminaison que Google utilise pour les messages de demande et les diffusions en direct Requêtes de prix lors de la configuration initiale Pour en savoir plus, contactez votre responsable de compte technique (TAM).
Google envoie un message de demande sous forme de requête HTTP POST avec l'Content-Type
en-tête défini sur "application/xml" et l'en-tête User-Agent défini sur
Google-HotelAdsPrices L'exception à cette règle se produit lors du test manuel
l'intégration du point de terminaison des prix via Google-TravelAds-Live. Ces échantillons
les requêtes peuvent contenir ou non l'en-tête User-Agent.
Pour plus d'informations sur la mise en forme détaillée des messages de requête, consultez la documentation de référence XML.
Messages de requête de prix
Les messages de demande de prix spécifient les combinaisons d'établissement et de séjour pour lesquelles vous fournissez les prix.
Lorsque votre serveur reçoit un message de requête de prix, il doit renvoyer un message <Transaction> comportant les informations tarifaires requises.
Pour en savoir plus, consultez la page Présentation des tarifs.
Il existe trois types spéciaux de messages de demande:
Prix en temps réel : si cette option est activée, des requêtes sont envoyées lorsqu'un utilisateur consulte activement les prix de la combinaison d'établissement ou de séjour spécifiée. Vous disposez d'un délai pour répondre.
Avec contexte:si cette option est activée, les recommandations de contexte utilisateur sont incluses dans pour chaque requête envoyée par Google et les recommandations les principaux types d'utilisateurs qui recherchent l'établissement ou le séjour en question ; combinaisons. Suivre ces recommandations peut améliorer l'efficacité de vos réponses.
Métadonnées : demande d'informations sur les chambres et les formules pour les établissements spécifiés.
Requêtes de prix en temps réel
Les requêtes de prix en temps réel sont des demandes de Google concernant des mises à jour de prix en temps réel en réponse aux recherches des utilisateurs. Google reçoit une requête de recherche d'un utilisateur concernant combinaison d'hôtel ou de séjour, et parce que les données tarifaires ne sont pas disponibles ou non Google vous demande de mettre à jour vos prix au moment de la recherche. Avec Lors d'une requête de prix en temps réel, Google tente d'obtenir un prix et de l'afficher dans le résultats au moment de la recherche.
Toutes les requêtes de prix en temps réel ont une limite de temps de réponse, généralement jusqu'à 4 000 millisecondes. Cette limite est spécifiée dans la requête de prix en temps réel requête. Si une réponse ne peut pas être fournie dans le délai imparti, cela entraîne le une participation manquée pour l'opportunité spécifique. Toutefois, nous vous recommandons de fournir un prix afin qu'il puisse être mis en cache et utilisé pour de futures opportunités. La connexion pour la réponse reste ouverte pendant 10 minutes ou aussi longtemps que spécifié dans la configuration du partenaire.
Les requêtes de prix en temps réel sont également contextuelles et peuvent récupérer les prix pour les paramètres suivants : pays de l'utilisateur, type d'appareil, nombre de personnes (nombre de clients) et profil des clients (adultes ou enfants). Avec les requêtes de prix en temps réel, vous pouvez peut afficher des prix plus à jour qui correspondent à la recherche du client.
Les requêtes de prix en temps réel constituent un système secondaire de mise à jour des prix. Les méthodes "Pull" ou "Modifié" sont toujours le principal mécanisme de calcul des nouveaux tarifs. la tarification. Les requêtes de prix en temps réel permettent de combler les lacunes lorsque Google ne dispose pas les prix des combinaisons hôtel/séjour.
Règles d'utilisation des requêtes de prix en temps réel
Aucune donnée mise en cache pour le séjour donné n'existe, car le séjour demandé est atypique, c'est-à-dire que les dates sont très éloignées dans le futur ou que l'hôtel est très rarement recherchés.
La date demandée n'est pas une date par défaut.
: Remarque : Les dates par défaut ne sont pas éligibles pour les requêtes de prix en temps réel. En direct les requêtes de prix ne sont demandées que pour des dates qui ne sont pas définies par défaut.
En général, Google met en cache les résultats d'une requête de prix en temps réel afin que le même hôtel ou séjour ne sont pas interrogées à nouveau. Il peut demander à la fois un seul hôtel ou un seul séjour ainsi que des combinaisons de plusieurs hôtels ou à un seul séjour.
La fonctionnalité de prix en temps réel en contexte nous permet de cibler nos requêtes de prix en temps réel en fonction du type d'appareil d'un utilisateur, du pays dans lequel il effectue la recherche et du nombre de personnes (y compris les enfants). Les
Le message de demande et le message Transaction sont développés pour inclure les
Élément <Context> qui définit les paramètres de requête. Les prix reçus en réponse aux requêtes de prix en temps réel en contexte peuvent être mis en cache sous la forme d'une offre de chambres (s'il s'agit d'un prix pour un nombre de personnes précis) et/ou d'un tarif sous conditions (s'il s'agit d'un prix spécifique au pays ou au type d'appareil de l'utilisateur).
Avec des requêtes contextuelles
Avec Context, les requêtes sont des demandes régulières de mise à jour de notre base de données pour les combinaisons de propriétés ou d'itinéraires spécifiées. Ils contiennent une liste d'utilisateurs qui sont populaires pour ces combinaisons. Si Tarifs sous conditions, puis les taux d'envoi pour tous les contextes d'utilisation possibles peuvent être coûteux. Vous pouvez donc utilisez cette liste de contextes utilisateur pour limiter votre réponse. Renvoyer les prix pour seulement les contextes utilisateur spécifiés couvrent la grande majorité des requêtes d'utilisateur pertinentes.
Si vous souhaitez recevoir des requêtes avec contexte, contactez votre responsable de compte technique (TAM). Il pourra confirmer que vous êtes prêt à recevoir des messages, puis ajustez la configuration pour commencer à envoyer des contextes utilisateur dans les requêtes qui vous sont adressées.
Messages de requête de métadonnées
Les messages de requête de métadonnées contiennent des informations sur les chambres et les offres de chambres pour les établissements spécifiés.
Lorsque vous recevez un message de requête de métadonnées, vous devez renvoyer un message <Transaction> comportant les tarifs pour les hôtels demandés dans les éléments <Result>.
Pour en savoir plus, consultez Définir des métadonnées de chambres et de formules.
Requêtes de contrôle
Cette section vous explique comment contrôler les établissements et itinéraires peut faire l'objet de messages de demande envoyés par Google.
Limites concernant le séjour
Vous déterminez les limites possibles des requêtes de prix en utilisant
<ItineraryCapabilities> Vous devez définir les règles qui déterminent la plage de dates et la durée maximale des séjours que vous acceptez.
Vous pouvez définir des valeurs par défaut pour <MaxAdvancePurchase> et <MaxLengthOfStay>
qui s'appliquent à toutes les combinaisons d'hôtel ou de séjour. Vous pouvez également définir ces paramètres pour des groupes d'hôtels.
Exemples de messages de requête
Cette section présente plusieurs exemples de messages de demande de prix, ainsi que Message de demande. Vous trouverez d'autres exemples dans le Documentation de référence sur les requêtes XML
Exemple de séjour
L'exemple suivant présente un <Query> de prix qui demande la mise à jour des prix
pour quatre hôtels, disponibles pour trois nuits et à partir du 23 mai 2023:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<Checkin>2023-05-23</Checkin>
<Nights>3</Nights>
<PropertyList>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</PropertyList>
</Query>
Dans cet exemple, le message demande la mise à jour des prix pour chaque hôtel :
5/23/18 - 6/26/18
Exemple de requête de prix en temps réel
L'exemple suivant présente une requête de prix en temps réel avec un délai de réponse limité de 500 millisecondes:
<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<!-- Note that the latencySensitive attribute is not present by default but can
be configured to be displayed, on request, by Google. This attribute is only
displayed for a Live Pricing Query request -->
<Checkin>2023-05-23</Checkin>
<Nights>2</Nights>
<DeadlineMs>500</DeadlineMs>
<!-- The deadline represents the timeframe by which a response will need to be
received by. This element is only displayed for a Live Pricing Query request -->
<PropertyList>
<Property>6781291</Property>
</PropertyList>
<!-- Note that Context tags are potentially repeatable -->
<Context>
<!-- The total number of guests occupying the room (adults+children) -->
<Occupancy>3</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
<!-- In this example one of the 3 guests is a 5yr old child -->
<Children>
<Child age="5"/>
</Children>
</OccupancyDetails>
<!-- The user was located in the US when this search was made -->
<UserCountry>US</UserCountry>
<!-- The user was searching from a mobile device at the time of search -->
<UserDevice>mobile</UserDevice>
</Context>
</Query>
Dans cet exemple, le message demande le prix d'un seul hôtel :
6/23/23 - 6/25/23
Vous trouverez un exemple de message de transaction à cette requête dans le Tarification et Documentation de référence XML sur l'inventaire des chambres (transactions)
Exemple de requête avec contexte
Voici un exemple de requête avec contexte:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<Checkin>2023-05-23</Checkin>
<Nights>2</Nights>
<PropertyContextList>
<PropertyContext>
<Property>8675309</Property>
<!-- In the future, occupancy and device might be specified -->
<Context><UserCountry>US</UserCountry></Context>
<Context><UserCountry>GB</UserCountry></Context>
</PropertyContext>
<PropertyContext>
<Property>8675310</Property>
<Property>8675311</Property>
<Context><UserCountry>CA</UserCountry></Context>
</PropertyContext>
</PropertyContextList>
</Query>
Avec les requêtes contextuelles, seul le contexte du pays de l'utilisateur est spécifié. À l'avenir, de telles requêtes pourront également spécifier l'appareil et l'occupation de l'utilisateur.
Plages de dates d'arrivée
Si vous utilisez le mode Requête de prix modifiés, la structure du message de demande dépend sur le type d'indice que vous utilisez pour les plages de dates d'arrivée, les mots clés exacts ou d'itinéraires inclus dans une période. Pour en savoir plus sur chacun de ces Pour en savoir plus, consultez la section Messages de réponse d'indication.
L'exemple suivant présente un message de prix <Query> pour la date d'arrivée
plages:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<FirstDate>2023-05-23</FirstDate>
<LastDate>2023-05-26</LastDate>
<Nights>3</Nights>
<PropertyList>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</PropertyList>
</Query>
Dans cet exemple, le message demande la mise à jour des prix pour les séjours suivants (pour chaque hôtel):
5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/24/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23
Séjours inclus dans une période
L'exemple suivant présente un message de prix <Query> pour une plage de dates
reste:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<FirstDate>2023-05-23</FirstDate>
<LastDate>2023-05-26</LastDate>
<AffectedNights>3</AffectedNights>
<PropertyList>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</PropertyList>
</Query>
Dans cet exemple, le message demande la mise à jour des prix pour chaque hôtel :
5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/25/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23
Cette requête s'applique également aux séjours débutant avant (mais incluant) la nuit du jour d'arrivée :
5/20/23 - 5/23/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23
5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23
Message de requête de métadonnées
L'exemple suivant montre un message <Query> qui demande des métadonnées
Mises à jour des informations sur les chambres et les formules pour plusieurs établissements:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<HotelInfoProperties>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</HotelInfoProperties>
</Query>
Pour répondre à ce type de message de requête, vous devez envoyer un message de transaction comportant les métadonnées des chambres et des offres de chambres. Pour en savoir plus, consultez la section Définir des métadonnées de chambres et de formules.