Messages de réponse d'indication

Lorsque nous envoyons un message Hint request, vos serveurs doivent y répondre par un message Hint Response spécifiant les hôtels dont les prix ont changé depuis la dernière fois que Google a reçu une réponse d'indication réussie de ces mêmes serveurs. En cas de changement de prix, Google envoie un <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 refacturation, consultez la présentation du système tarifaire.

Les messages de réponse d'indication utilisent les méthodes suivantes pour mettre à jour les prix des hôtels sélectionnés et de leurs séjours:

L'élément racine d'un message de réponse d'indication est <Hint>. Pour demander la modification 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 un nombre illimité d'éléments <Item>.

Chaque message de réponse d'indication doit spécifier au moins un élément <Property> pour chaque élément <Item>. L'élément <Property> identifie un hôtel en utilisant les mêmes identifiants que ceux de la liste d'hôtels. Par défaut, vous spécifiez un seul ID d'hôtel pour chaque bloc <Item>. Toutefois, vous pouvez demander à Google d'autoriser plusieurs hôtels dans un bloc d'articles si vous utilisez des plages de dates d'arrivée ou des séjours inclus dans une période pour mettre à jour les prix.

Flux de requêtes et de réponses pour un séjour exact

Les messages d'indication peuvent être basés sur des séjours individuels, comme la 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 Google récupère 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 établissement 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 <Query> semblable à celui-ci:

<Query>
  <Checkin>2023-05-20</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

Créer (<Transaction>)

Vous devez ensuite créer un <Transaction> en mettant à jour les prix de l'hôtel pour le séjour suivant:

5/20/23 - 5/23/23

Flux des demandes et des réponses pour les plages 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 première date d'arrivée à la dernière date d'arrivée. Lorsque Google récupère de nouvelles données tarifaires, il extrait les séjours correspondant à chaque date d'arrivée à l'hôtel, en commençant par ces dates et jusqu'à la durée du séjour indiquée.

Périodes 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 répondons à ce message de réponse d'indication par un message <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 une <Transaction> en mettant à jour les prix pour les séjours suivants de cet hôtel:

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 par défaut de cinq nuits est utilisée.

Flux des requêtes et des réponses pour les séjours inclus dans une période

Un message de réponse d'indication peut inclure une période de dates qui ont changé. Google doit alors récupérer tous les séjours concernés par l'une de ces dates. L'ensemble réel de séjours récupérés dépend à la fois des dates avec modifications et de la durée maximale du séjour.

Séjours inclus dans une période du partenaire

L'exemple de message de réponse d'indication suivant utilise 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 <Query> semblable à celui-ci:

<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 <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