Messages de réponse d'indication

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 récupère les données tarifaires mises à jour pour des hôtels et des itinéraires.

Pour en savoir plus sur le processus de modification des prix, consultez la 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 leurs itinéraires:

L'élément racine d'un message Hint response est <Hint>. Vous demandez un hôtel ou voyage à mettre à jour en utilisant un ou plusieurs éléments <Item>. Un seul indice Un message de réponse 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 identifiants que la liste d'hôtels. Par défaut, vous spécifiez un seul ID d'hôtel pour chaque <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 itinéraires individuels, comme la combinaison de la date d'arrivée et la durée du séjour. Dans ce cas, vous spécifiez une date d'arrivée et la durée du séjour pour vos hôtels. Google récupère alors les nouvelles données tarifaires cet itinéraire.

Réponse du partenaire

Le message de réponse d'indication suivant définit une seule propriété et une seule 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 <Transaction> avec des mises à jour de prix pour le 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 Google récupère de nouvelles données tarifaires, Google extrait les séjours pour chaque date d'arrivée à l'hôtel à partir de ces dates et s'étendant jusqu'à la durée du séjour que vous indiquez.

Plage de dates du partenaire

L'exemple suivant de message de réponse d'indication définit une seule propriété 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 une valeur <Query> semblable à celle-ci : les éléments suivants:

<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 des mises à jour de 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 changé. Ce informe Google qu'il doit récupérer tous les itinéraires affectés par l'un de ces dates. L'ensemble réel d'itinéraires récupéré est une fonction de l'ensemble des dates avec modifications et 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 <Query> semblable à celui-ci : suivantes:

<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 des mises à jour de prix pour le 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