Messages de réponse d'indication

Lorsque Google envoie un message de demande d'indication, vos serveurs doivent y répondre avec un message de réponse d'indication. Celui-ci spécifie les hôtels dont les prix ont changé depuis la dernière fois où Google a reçu une réponse d'indication de la part de ces mêmes serveurs. Si des prix sont modifiés, Google envoie une notification <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 refacturation, consultez la page Présentation de la tarification.

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>. Vous demandez la mise à jour d'un hôtel ou d'un séjour en utilisant un ou plusieurs éléments <Item>. Un seul 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 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 les nouveaux tarifs.

Flux de demande et de réponse exactes du séjour

Les messages d'indication peuvent être basés sur des séjours individuels (par exemple, en combinant la date d'arrivée et la durée du séjour). Dans ce cas, vous spécifiez la date d'arrivée et la durée du séjour de vos hôtels, et Google récupère les nouvelles données tarifaires pour ce séjour uniquement.

Réponse du partenaire

Le message de réponse d'indication suivant définit une propriété et un séjour uniques:

<Hint>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2023-05-20</CheckInDate>
      <LengthOfStay>3</LengthOfStay>
    </Stay>
  </Item>
</Hint>

Réponse de Google

Google répond à votre message de réponse d'indication par un <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> avec des mises à jour des prix de l'hôtel pour le séjour suivant:

5/20/23 - 5/23/23

Flux de demande et de réponse 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 extrait les nouvelles données tarifaires, Google extrait les séjours pour chaque date d'arrivée à l'hôtel à partir de ces dates et jusqu'à la durée du séjour que vous indiquez.

Dates du partenaire

L'exemple suivant de message de réponse d'indication définit une propriété unique 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

Google répond à ce message de réponse d'indication par un <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 des mises à jour des prix pour les séjours suivants dans l'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 est de 5 nuits.

Flux de requête et de réponse pour les séjours inclus dans une période

Un message de réponse d'indication peut inclure une plage de nuits pour un séjour. Cela nous informe qu'il doit récupérer tous les séjours qui incluent au moins l'une de ces nuits. L'ensemble d'itinéraires récupéré dépend à la fois de l'ensemble des nuits dont les prix sont modifiés et de la durée maximale du séjour.

Séjours inclus dans une chambre 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

Google répond à votre message de réponse d'indication par un <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> avec des mises à jour des 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