Messages de réponse d'indication

Lorsque nous envoyons un message Hint request, vos serveurs doivent y répondre par un message de réponse d'indication 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 la part de ces mêmes serveurs. En cas de changement de prix, Google envoie un message <Query> qui récupère les données tarifaires mises à jour pour les hôtels et séjours indiqués.

Pour en savoir plus sur le processus de mise à jour des prix, consultez la page Présentation des tarifs.

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 mise à jour d'un hôtel ou d'un séjour, utilisez 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 <Item>. <Property> identifie un hôtel à l'aide des mêmes ID que ceux indiqués dans 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 "item" 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ête et de réponse pour un séjour exact

Les messages d'indication peuvent être basés sur des itinéraires individuels, par exemple 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. Google récupère alors 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 objet <Transaction> en mettant à jour les prix de l'hôtel pour le séjour suivant:

5/20/23 - 5/23/23

Flux des requêtes et des réponses pour des plages de dates d'arrivée

Un message de réponse d'indication peut spécifier une plage de dates d'arrivée, commençant par la première date d'arrivée et se terminant par la dernière date d'arrivée. Lorsque nous récupérons de nouvelles données tarifaires, nous récupérons les séjours pour chaque date d'arrivée à l'hôtel à partir de ces dates et jusqu'à la durée de séjour indiquée.

Périodes correspondant à une période du partenaire

L'exemple suivant de message de réponse d'indication définit un seul établissement avec 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 un objet <Transaction> en mettant à jour les prix pour les séjours suivants dans 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

Cet exemple utilise la durée de séjour par défaut de cinq nuits.

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

Un message de réponse d'indication peut inclure une plage de dates qui ont été modifiées. Google est ainsi informé qu'il doit récupérer tous les séjours affectés par l'une de ces dates. L'ensemble réel de séjours récupéré est une fonction à la fois de l'ensemble de dates avec modifications et de la durée maximale du séjour.

Séjours inclus dans une période du partenaire

Dans l'exemple suivant, le message de réponse d'indication 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 objet <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