Messages de réponse d'indication

Lorsque Google envoie un message Hint request, vos serveurs doivent répondre par un message Hint response qui spécifie 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 message <Query> qui extrait les données tarifaires mises à jour pour les hôtels et séjours indiqués.

Pour en savoir plus sur la procédure de mise à jour des prix, consultez la section Présentation des tarifs.

Les messages Hint response utilisent les méthodes suivantes pour modifier les prix des hôtels et des séjours sélectionnés:

• Séjours exacts
• Plages de dates d'arrivée
• Séjours inclus dans une période

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, vous devez utiliser 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 comporter au moins un élément <Property> pour chaque élément <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 seul identifiant d'hôtel pour chaque bloc <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 requêtes et réponses pour un séjour exact

Les messages d'indication peuvent être basés sur des séjours individuels, comme la combinaison de la date d'arrivée et de la durée du 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.

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

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

5/20/23 - 5/23/23

Flux de requêtes et de réponses pour une plage 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 plus proche à la plus éloignée. Lorsque Google récupère de nouvelles données tarifaires, il extrait les séjours pour chaque date d'arrivée de l'hôtel à partir de ces dates et jusqu'à la durée de séjour que vous indiquez.

<Hint>
  <Item>
    <Property>12345</Property>
    <FirstDate>2023-05-20</FirstDate>
    <LastDate>2023-05-23</LastDate>
  </Item>
</Hint>

<Query>
  <FirstDate>2023-05-20</FirstDate>
  <LastDate>2023-05-23</LastDate>
  <Nights>5</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

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

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é. Nous devons alors récupérer tous les séjours qui sont affectés par l'une de ces dates. Le groupe de séjours récupéré combine à la fois les dates avec les modifications et la durée maximale du séjour indiquée.

<Hint>
  <Item>
    <Property>12345</Property>
    <StaysIncludingRange>
      <FirstDate>2023-05-20</FirstDate>
      <LastDate>2023-05-23</LastDate>
    </StaysIncludingRange>
  </Item>
</Hint>

<Query>
  <FirstDate>2023-05-20</FirstDate>
  <LastDate>2023-05-23</LastDate>
  <AffectedNights>3</AffectedNights>
  <PropertyList>
    <Property>12345</Property>
    <Property>67891</Property>
  </PropertyList>
</Query>

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