Messages de réponse d'indication

Lorsque Google envoie un message Hint request, vos serveurs doivent y répondre avec un message Hint response. 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 Hint response 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 présentation des tarifs.

Les messages Hint response utilisent les méthodes suivantes pour modifier les prix des hôtels sélectionnés et de leurs séjours :

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 message de réponse d'indication peut définir plusieurs é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 le même ID que celui défini 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 messages de requête et de réponse pour un séjour exact

Les messages d'indication peuvent être basés sur des séjours individuels (combinaison d'une date d'arrivée et d'une durée de 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 des messages de requête et de réponse 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.

Plages de dates du partenaire

Dans l'exemple ci-dessous, le message de réponse d'indication définit un hôtel 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 du 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 spécifier une plage de dates qui ont changé. Nous devons alors récupérer tous les séjours qui contiennent au moins l'une de ces dates. Le groupe de séjours récupéré combine à la fois l'ensemble des dates avec les prix modifiés et la durée maximale du séjour indiquée.

Séjours avec dates flexibles du partenaire

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