Messages de réponse d'indication

Lorsque nous envoyons 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ù nous avons reçu un message de réponse d'indication de la part de vos serveurs. En cas de changement de prix, nous envoyons un <Query> qui récupère les nouvelles données tarifaires des hôtels et séjours indiqués.

Pour obtenir une vue d'ensemble du processus de modification des prix, consultez la section Présentation des prix.

Les messages de réponse d'indication 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, utilisez un ou plusieurs <Item> éléments. 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 <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 <Item> bloc. 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, 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 nous récupérons les nouvelles données tarifaires uniquement pour ce séjour.

Réponse du partenaire

Le message de réponse Hint request suivant définit une seule propriété 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 Hint request 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 élément <Transaction> avec les modifications de prix pour 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 Hint request 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. Lors 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

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 réponse Hint request <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 <Transaction> avec les modifications de prix pour les séjours suivants pour 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 du séjour est de cinq nuits. La durée du 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é. Cela indique à Google qu'il doit récupérer tous les séjours concernés par l'une de ces dates. Le groupe de séjours récupéré est fonction à la fois des dates avec les 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 Hint request ci-dessous 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 Hint request 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 <Transaction> avec les modifications de prix pour 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