Mensajes de respuesta con sugerencias

Cuando Google envía un mensaje de Hint Request, tus servidores deben responder con un mensaje de Hint Response que especifique los hoteles cuyos precios cambiaron desde la última vez que Google recibió un mensaje de Hint Response exitoso de esos mismos servidores. Si hay cambios en los precios, Google envía un objeto <Query> que recupera los datos de precios actualizados para los hoteles y los itinerarios indicados.

Para obtener una descripción general del proceso de cambio de precios, consulta la Descripción general de los precios.

Los mensajes de respuesta de sugerencia utilizan los siguientes métodos para volver a calcular el precio de los hoteles seleccionados y sus itinerarios:

El elemento raíz de un mensaje de respuesta con sugerencias es <Hint>. Solicitas que se actualice un hotel o un itinerario con uno o más elementos <Item>. Un solo mensaje de HintResponse puede definir cualquier cantidad de elementos <Item>.

Cada mensaje de respuesta de sugerencia debe especificar al menos un elemento <Property> para cada <Item>. El objeto <Property> identifica un hotel con los mismos IDs que la lista de hoteles. De forma predeterminada, especificas un solo ID de hotel para cada bloque de <Item>. Sin embargo, puedes indicarle a Google que permita varios hoteles en un bloque de elementos si usas rangos de fechas de entrada o estadías con rangos para el cambio de precios.

Flujo exacto de solicitud y respuesta del itinerario

Los mensajes de sugerencia pueden basarse en itinerarios individuales, como la combinación de la fecha de entrada y la duración de la estadía. En este caso, especificas una fecha de entrada y una duración de la estadía para tus hoteles, y Google recupera los nuevos datos de precios solo para ese itinerario.

Respuesta del socio

El siguiente mensaje de respuesta de sugerencia define una sola propiedad y un solo itinerario:

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

Respuesta de Google

Google responde a tu mensaje de Hint Response con un <Query> similar al siguiente:

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

Crear <Transaction>

Luego, se espera que crees un objeto <Transaction> con actualizaciones de precios para el hotel en la siguiente estadía:

5/20/23 - 5/23/23

Flujo de solicitud y respuesta de los períodos de fechas de entrada

Un mensaje de Hint Response puede especificar un rango de fechas de entrada, que comienza con la primera fecha de entrada y finaliza con la última. Cuando Google recupera datos de precios nuevos, extrae itinerarios para cada fecha de entrada del hotel, comenzando por esas fechas y extendiéndose hasta la duración de la estadía que indiques.

Fechas de rango del socio

En el siguiente ejemplo del mensaje de respuesta de sugerencia, se define una sola propiedad con un rango de fechas para el registro:

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

Respuesta de Google

Google responde a este mensaje de Hint Response con <Query> de forma similar a la siguiente:

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

Crear <Transaction>

Luego, se espera que crees un objeto <Transaction> con actualizaciones de precios para las siguientes estadías en ese hotel:

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

En este ejemplo, se usa una duración de la estadía de 5 noches. La duración predeterminada de la estadía es de 30 días.

Flujo de solicitud y respuesta de estadías con rango

Un mensaje de respuesta de sugerencia puede incluir un rango de fechas que cambiaron. Esto le informa a Google que debe recuperar cualquier itinerario afectado por alguna de esas fechas. El conjunto real de itinerarios recuperados es una función del conjunto de fechas con cambios y la duración máxima de la estadía.

Estadías con precios variables del socio

En el siguiente ejemplo de mensaje de respuesta de sugerencia, se usan estadías con rangos:

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

Respuesta de Google

Google responde a tu mensaje de Hint Response con un <Query> similar al siguiente:

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

Crear <Transaction>

Luego, se espera que crees un objeto <Transaction> con actualizaciones de precios para el hotel en las siguientes estadías:

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