Sugerencias de mensajes de respuesta

Cuando Google envía un mensaje de solicitud de sugerencia, tus servidores deben responder con un mensaje de respuesta de sugerencia que especifique los hoteles cuyos precios cambiaron desde la última vez que Google recibió una respuesta de sugerencia correcta de esos mismos servidores. Si hay algún cambio de precio, Google envía un <Query> que recupera los datos de precios actualizados de los hoteles y los itinerarios indicados.

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

Los mensajes de respuesta de sugerencias usan los siguientes métodos para volver a establecer el precio de los hoteles seleccionados y sus itinerarios:

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

Cada mensaje de respuesta de sugerencia debe especificar al menos un elemento <Property> para cada <Item>. <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 <Item>. Sin embargo, puedes indicarle a Google que permita varios hoteles en un bloque de artículos si usas rangos de fechas de entrada o de estadías para volver a establecer precios.

Flujo de solicitud y respuesta de itinerario exacto

Los mensajes de sugerencias 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 datos de precios nuevos 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 respuesta de sugerencia 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 <Transaction> con las actualizaciones de precios del hotel para la siguiente estadía:

5/20/23 - 5/23/23

Flujo de solicitud y respuesta de los períodos de registro

Un mensaje de respuesta de sugerencia 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, a partir de esas fechas y hasta la duración de la estadía que indiques.

Fechas del socio

En el siguiente ejemplo de 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 respuesta de sugerencia con <Query> similar a lo 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 <Transaction> con las actualizaciones de precios para las siguientes estadías de 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 de la estadía predeterminada 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 cualquiera 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.

Estadias del socio en un rango

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 respuesta de sugerencia 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 <Transaction> con las actualizaciones de precios del hotel para 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