Cuando Google envía un mensaje de solicitud de sugerencia, los 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 itinerarios y hoteles indicados.
Para obtener una descripción general del proceso de revisión de precios, consulta la Descripción general de los precios.
En los mensajes de respuesta de sugerencias, se usan los siguientes métodos para cambiar los precios de los hoteles seleccionados y sus itinerarios:
El elemento raíz de un mensaje de respuesta de sugerencia es <Hint>. Solicitas que se actualice un hotel o itinerario mediante uno o más elementos <Item>. Un solo mensaje de Hint Response puede definir cualquier cantidad de elementos <Item>.
Cada mensaje de respuesta de sugerencia debe especificar al menos un elemento <Property> para cada <Item>. El <Property> identifica un hotel con los mismos ID 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 elementos si usas períodos de entrada o estadías en períodos para la revisión de precios.
Solicitud del itinerario exacto y flujo de respuesta
Los mensajes de sugerencia se pueden basar en itinerarios individuales, como la combinación de fecha de entrada y duración de la estadía. En este caso, debes especificar una fecha de entrada y la 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 Hint Response 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 sugerencias con una <Query> similar a la 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 actualizaciones de precios del hotel para la siguiente estadía:
5/20/23 - 5/23/23
Solicitud de períodos de entrada y flujo de respuesta
Un mensaje de Hint Response puede especificar un rango de fechas de entrada, que comienza con la primera fecha de entrada y termina con la última. Cuando Google recupera datos de precios nuevos, busca 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 establecidas por el socio
En el siguiente ejemplo, para el mensaje de respuesta de sugerencias, se define una sola propiedad con un rango de fechas para el registro de entrada:
<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 sugerencias con <Query> similar al 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 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 la duración predeterminada de la estadía de 5 noches.
Solicitud de estadías con rango y flujo de respuesta
Un mensaje de Hint Response puede incluir un rango de fechas que han cambiado. Esto informa a Google que debe recuperar todos los itinerarios afectados por cualquiera de esas fechas. El conjunto real de itinerarios recuperados es una función tanto del conjunto de fechas con cambios como de la duración máxima de la estadía.
Alojamientos de la pareja
En el siguiente mensaje de respuesta de sugerencia de ejemplo, se usan estadías de rango:
<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 sugerencias con una <Query> similar a la 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 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