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 correcta de sugerencia de esos mismos servidores. Si hay algún cambio de precio, Google envía un objeto <Query> que recupera los datos de precios actualizados de los itinerarios y los hoteles 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 a sugerencias usan los siguientes métodos para cambiar el precio de los hoteles seleccionados y sus itinerarios:
El elemento raíz de un mensaje de respuesta de sugerencia es <Hint>. Para solicitar la actualización de un hotel o itinerario, debes usar 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>. El <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 períodos de entrada o estadías a intervalos para la revisión de precios.
Solicitud de itinerario exacto y flujo de respuesta
Los mensajes de sugerencias se pueden basar 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 la duración de la estadía de tus hoteles, y Google recuperará los nuevos datos de precios de ese itinerario.
Respuesta del socio
En el siguiente mensaje de respuesta de sugerencia, se 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 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>
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 registro y flujo de respuesta
Un mensaje de respuesta de sugerencia puede especificar un rango de fechas de entrada, que comienza con la primera fecha de entrada y termina con la última fecha de entrada. Cuando Google recupera datos de precios nuevos, extrae itinerarios para cada fecha de entrada en el hotel. Comienza con esas fechas y se extienden hasta la duración de la estadía que tú indiques.
Fechas rotadas 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 este mensaje de respuesta de sugerencia con una <Query> 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>
Por lo tanto, se espera que crees un <Transaction> con actualizaciones de precios para las siguientes estadías del 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 limitadas y flujo de respuesta
Un mensaje de respuesta de sugerencia puede incluir un rango de fechas que han cambiado. 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.
Estadías a intervalos del socio
En el siguiente ejemplo de mensaje de respuesta de sugerencia, se usan estadías con intervalos:
<Hint>
<Item>
<Property>12345</Property>
<StaysIncludingRange>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
</StaysIncludingRange>
</Item>
</Hint>
Respuesta de Google
Google responde 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>
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