Lorsque Google envoie un message Hint request, vos serveurs doivent y répondre avec un message de réponse d'indication. Celui-ci doit spécifier les hôtels dont les prix ont changé depuis la dernière fois où Google a reçu un message de réponse d'indication de la part de vos serveurs. En cas de changement de prix, Google envoie un message <Query>
qui extrait les données tarifaires mises à jour pour les hôtels et séjours indiqués.
Pour en savoir plus sur le processus de modification des prix, consultez la section Présentation des tarifs.
Les messages Hint response utilisent les méthodes suivantes pour modifier les prix des hôtels et des séjours sélectionnés:
L'élément racine d'un message Hint response est <Hint>
. Pour demander la mise à jour d'un hôtel ou d'un séjour, vous devez utiliser un ou plusieurs éléments <Item>
. Un seul message de réponse d'indication peut définir un nombre illimité d'éléments <Item>
.
Chaque message de réponse d'indication doit comporter au moins un élément <Property>
pour chaque élément <Item>
. L'élément <Property>
identifie un hôtel en utilisant les mêmes ID que ceux définis dans la liste d'hôtels pour l'établissement concerné. Par défaut, vous spécifiez un identifiant d'hôtel unique pour chaque bloc <Item>
. Toutefois, vous pouvez nous indiquer plusieurs hôtels dans un bloc "<Item>" si vous utilisez des plages de dates d'arrivée ou des séjours inclus dans une période pour mettre à jour vos prix.
Flux des requêtes et réponses pour un séjour exact
Les messages d'indication peuvent être basés sur des séjours individuels, comme la combinaison de la date d'arrivée et de la durée du séjour. Dans ce cas, vous spécifiez une date d'arrivée et une durée de séjour pour vos hôtels, et nous récupérons les nouvelles données tarifaires uniquement pour ce séjour.
Réponse du partenaire
Le message de réponse d'indication suivant définit un seul hôtel et un seul séjour:
<Hint>
<Item>
<Property>12345</Property>
<Stay>
<CheckInDate>2023-05-20</CheckInDate>
<LengthOfStay>3</LengthOfStay>
</Stay>
</Item>
</Hint>
Réponse de Google
Nous répondons à votre message de réponse d'indication par un message de requête <Query>
semblable à ce qui suit:
<Query>
<Checkin>2023-05-20</Checkin>
<Nights>3</Nights>
<PropertyList>
<Property>12345</Property>
</PropertyList>
</Query>
Créer <Transaction>
Vous devez ensuite créer un message <Transaction>
en mettant à jour les prix de l'hôtel pour le séjour suivant:
5/20/23 - 5/23/23
Flux de requêtes et de réponses pour une plage de dates d'arrivée
Un message de réponse d'indication peut spécifier une plage de dates d'arrivée, allant de la plus proche à la plus éloignée. Lorsque nous récupérons de nouvelles données tarifaires, notre système extrait les séjours correspondant à chaque date d'arrivée à l'hôtel spécifiée et à la durée du séjour indiquée.
Plage de dates du partenaire
L'exemple suivant de message de réponse d'indication définit un seul établissement et une plage de dates d'arrivée:
<Hint>
<Item>
<Property>12345</Property>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
</Item>
</Hint>
Réponse de Google
Nous y répondons par un message de requête <Query>
semblable à celui-ci:
<Query>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
<Nights>5</Nights>
<PropertyList>
<Property>12345</Property>
</PropertyList>
</Query>
Créer <Transaction>
Vous devez ensuite créer un message <Transaction>
en mettant à jour les prix de l'hôtel pour les séjours suivants:
5/20/23 - 5/21/23
5/20/23 - 5/22/23
5/20/23 - 5/23/23
5/20/23 - 5/24/23
5/20/23 - 5/25/23
5/21/23 - 5/22/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23
5/21/23 - 5/25/23
5/21/23 - 5/26/23
5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23
5/22/23 - 5/26/23
5/22/23 - 5/27/23
Dans cet exemple, la durée de séjour est de cinq nuits. La durée de séjour par défaut est de 30 jours.
Flux des messages de requête et de réponse pour des séjours inclus dans une période
Un message de réponse d'indication peut inclure une plage de dates qui ont changé. Nous devons alors récupérer tous les séjours qui sont affectés par l'une de ces dates. Le groupe de séjours récupéré combine à la fois les dates avec les modifications et la durée maximale du séjour indiquée.
Séjours du partenaire sur une période donnée
Dans l'exemple ci-dessous, le message de réponse d'indication définit des séjours inclus dans une période:
<Hint>
<Item>
<Property>12345</Property>
<StaysIncludingRange>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
</StaysIncludingRange>
</Item>
</Hint>
Réponse de Google
Nous répondons à votre message de réponse d'indication par un message de requête <Query>
semblable à ce qui suit:
<Query>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
<AffectedNights>3</AffectedNights>
<PropertyList>
<Property>12345</Property>
<Property>67891</Property>
</PropertyList>
</Query>
Créer <Transaction>
Vous devez ensuite créer un message <Transaction>
en mettant à jour les prix de l'hôtel pour les séjours suivants:
5/17/23 - 5/20/23
5/18/23 - 5/20/23
5/18/23 - 5/21/23
5/19/23 - 5/20/23
5/19/23 - 5/21/23
5/19/23 - 5/22/23
5/20/23 - 5/21/23
5/20/23 - 5/22/23
5/20/23 - 5/23/23
5/21/23 - 5/22/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
5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23