Los mensajes de consulta son solicitudes de Google de actualizaciones de precios o metadatos. Ellas se usan con la solicitud de precios a terceros y los precios modificados modos de entrega.
El elemento raíz de los mensajes de consulta es <Query>.
La estructura del mensaje Query depende del tipo de mensaje:
Precio: Google envía un mensaje de consulta que solicita actualizaciones de precios para de los hoteles especificados.
Metadatos: Google envía un mensaje de consulta en el que se solicitan datos sobre la sala. y la información del paquete en los hoteles especificados.
Tú defines el extremo que Google usará para los mensajes de consulta y las transmisiones en vivo Consultas de precios durante la configuración inicial Para obtener más información, comunícate con tu administrador técnico de cuentas (TAM).
Google envía un mensaje de consulta como una solicitud POST HTTP con el Content-Type.
el encabezado está configurado como “application/xml” y el encabezado User-Agent establecido en
Google-HotelAdsPrices La excepción a esta regla se produce durante la prueba manual del
la integración de extremos de precios a través de Google-TravelAds-Live Esas muestras
las consultas pueden contener o no el encabezado User-Agent.
Puedes encontrar el formato detallado para los mensajes de consulta en Referencia de XML de consulta.
Mensajes de consulta de precios
Los mensajes de consulta de precios especifican las combinaciones de propiedades o itinerarios para las que tú proporcionas los precios.
Cuando tu servidor recibe un mensaje de consulta de pricing, debe responder con un
Es un mensaje <Transaction> que contiene la información de precios solicitada.
Para obtener más información, consulta la descripción general de los precios.
Existen tres tipos especiales de mensajes de consulta:
Precios en tiempo real: Si están habilitados, se envían consultas cuando un usuario está activamente. buscar precios para la propiedad o combinación de itinerarios especificada y tú tienen un plazo específico para responder.
Con contexto: Si está habilitada, se incluyen recomendaciones relacionadas con el contexto del usuario en cada consulta que Google te envía y las recomendaciones reflejan más tipos comunes de usuarios que buscan la propiedad o el itinerario determinado combinaciones. Seguir estas recomendaciones puede aumentar la eficiencia de tus respuestas.
Metadatos: Es una solicitud de detalles sobre habitaciones y paquetes del propiedades especificadas.
Consultas de precios en tiempo real
Las consultas de precios en tiempo real son solicitudes de Google de actualizaciones de precios en tiempo real en a las búsquedas de los usuarios. Google recibe una solicitud de búsqueda de un usuario sobre un una combinación de hotel o itinerario, y debido a que los datos de precios no están disponibles o no actual, Google te solicitará que actualices el precio en el momento de la búsqueda. Con Para realizar una consulta de precios en tiempo real, Google intenta obtener un precio y mostrarlo en resultados en el momento de la búsqueda.
Todas las solicitudes de consultas de precios en tiempo real tienen un límite de tiempo de respuesta que, por lo general, es de hasta 4,000 milisegundos. Este límite se especifica en la consulta de precios en tiempo real para cada solicitud. Si no se puede proporcionar una respuesta dentro del límite de tiempo, una participación perdida para esa oportunidad específica. Sin embargo, recomendamos proporcionar un precio de todos modos para que pueda almacenarse en caché y usarse para futuras oportunidades. La conexión para la respuesta permanece abierta durante diez minutos o como especificadas en la configuración del socio.
Las consultas de precios en tiempo real también son contextuales y pueden recuperar los precios de las los siguientes parámetros: país del usuario, tipo de dispositivo, ocupación (cantidad de huéspedes) y si esos invitados son adultos o niños. Con las consultas de precios en tiempo real, puedes puede mostrar precios más actualizados que coincidan con lo que el cliente buscó.
El objetivo de las consultas de precios en tiempo real es ser un mecanismo secundario de fijación de precios actualizaciones. El mecanismo principal para la revisión de precios aún es a través de la solicitud de precios a terceros o los cambios. los precios. Las consultas de precios en tiempo real ayudan a cerrar las brechas en las que Google no tiene precios para las combinaciones de hotel o itinerario.
Reglas para usar las consultas de precios en tiempo real
No existen datos almacenados en caché para el itinerario indicado porque el itinerario solicitado es atípica, como las fechas son muy lejanas o el hotel es muy buscados con poca frecuencia.
La fecha solicitada no es la predeterminada.
: Nota: Las fechas predeterminadas no son aptas para las consultas de precios en tiempo real. Transmisiones en vivo las consultas de precios solo se solicitan para fechas no predeterminadas.
Google suele almacenar en caché los resultados de un precio en tiempo real para que el mismo hotel o itinerario no se consultan nuevamente. Puede solicitar un solo hotel o itinerario de hotel, así como combinaciones de varios hoteles o itinerarios.
La función Precios en tiempo real con contexto permite que Google envíe
Las solicitudes de precios en tiempo real se basan en el tipo de dispositivo del usuario, el país desde el cual
que buscan y la cantidad de ocupantes, incluidos los niños. Tanto el
Los mensajes de consulta y de transacción se expanden para incluir el
El elemento <Context> que define los parámetros de consulta. Precios recibidos de
Las consultas de precios en tiempo real con contexto se pueden almacenar en caché como un paquete de habitación.
si es un precio para una ocupación específica y una tarifa condicional
si es para el país o dispositivo del usuario.
Con consultas de contexto
Con Context, las consultas son solicitudes regulares para actualizar nuestra base de datos para el combinaciones especificadas de propiedades o itinerarios. Contienen una lista de usuarios contextos que son populares para esas combinaciones. Si Se usa Tarifas condicionales y, luego, las tasas de envío para todos los contextos de usuario posibles usa esta lista de contextos de usuario para limitar tu respuesta. Precios recurrentes solo por los contextos de usuario especificados cubren la gran mayoría de las búsquedas relevantes de los usuarios.
Mensajes de consulta de metadatos
Los mensajes de consulta de metadatos contienen detalles sobre la información de la habitación y el paquete para las propiedades especificadas.
Cuando recibes un mensaje de consulta metadata, debes responder con
un mensaje <Transaction> que especifica el precio de las propiedades solicitadas
en elementos <Result>.
Para obtener más información, consulta Define metadatos de habitaciones y paquetes.
Consultas de control
En esta sección, se describe cómo controlar qué itinerarios y propiedades puede ser el asunto de los mensajes de Consulta de Google.
Límites de itinerarios
Determinas los posibles límites de las consultas de precios usando
<ItineraryCapabilities> Tú defines las reglas que determinan el intervalo de fechas
y las duraciones máximas de estadía que admites.
Puedes establecer valores predeterminados para <MaxAdvancePurchase> y <MaxLengthOfStay>
que se aplican a todas las combinaciones de hoteles o itinerarios. También puedes definir estas
configuración de los grupos de hoteles.
Ejemplos de mensajes de consulta
En esta sección, se muestran varios ejemplos de mensajes de consulta de precios y un metadato Mensaje de consulta. Puedes encontrar ejemplos adicionales en el Referencia de XML de consulta.
Itinerario de muestra
En el siguiente ejemplo, se muestra un <Query> de precios que solicita actualizaciones de precios.
para 4 hoteles, disponible por 3 noches, y a partir del 23 de mayo de 2023:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<Checkin>2023-05-23</Checkin>
<Nights>3</Nights>
<PropertyList>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</PropertyList>
</Query>
En este ejemplo, se solicitan actualizaciones de precios para cada hotel:
5/23/18 - 6/26/18
Ejemplo de consulta de precios en tiempo real
En el siguiente ejemplo, se muestra una consulta de precios en tiempo real con un límite de tiempo de respuesta de 500 milisegundos:
<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<!-- Note that the latencySensitive attribute is not present by default but can
be configured to be displayed, on request, by Google. This attribute is only
displayed for a Live Pricing Query request -->
<Checkin>2023-05-23</Checkin>
<Nights>2</Nights>
<DeadlineMs>500</DeadlineMs>
<!-- The deadline represents the timeframe by which a response will need to be
received by. This element is only displayed for a Live Pricing Query request -->
<PropertyList>
<Property>6781291</Property>
</PropertyList>
<!-- Note that Context tags are potentially repeatable -->
<Context>
<!-- The total number of guests occupying the room (adults+children) -->
<Occupancy>3</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
<!-- In this example one of the 3 guests is a 5yr old child -->
<Children>
<Child age="5"/>
</Children>
</OccupancyDetails>
<!-- The user was located in the US when this search was made -->
<UserCountry>US</UserCountry>
<!-- The user was searching from a mobile device at the time of search -->
<UserDevice>mobile</UserDevice>
</Context>
</Query>
En este ejemplo, se solicita un precio para un solo hotel:
6/23/23 - 6/25/23
Puedes encontrar una respuesta de mensaje de transacción de muestra para esta consulta en el Precios y Referencia de XML para el inventario (transacciones) de Room.
Con un ejemplo de consulta de contexto
A continuación, se muestra un ejemplo de una consulta con contexto:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<Checkin>2023-05-23</Checkin>
<Nights>2</Nights>
<PropertyContextList>
<PropertyContext>
<Property>8675309</Property>
<!-- In the future, occupancy and device might be specified -->
<Context><UserCountry>US</UserCountry></Context>
<Context><UserCountry>GB</UserCountry></Context>
</PropertyContext>
<PropertyContext>
<Property>8675310</Property>
<Property>8675311</Property>
<Context><UserCountry>CA</UserCountry></Context>
</PropertyContext>
</PropertyContextList>
</Query>
Con las búsquedas de contexto, solo se especifica el contexto del país del usuario. En el futuro, también puede especificar el dispositivo y la ocupación del usuario.
Períodos de entrada
Si usa precios modificados, la estructura del mensaje Consulta depende en el tipo de sugerencia que usa para los períodos de entrada, valores exactos itinerarios variados o a intervalos. Para obtener más información sobre cada uno de estos tipos de sugerencias, consulta Mensajes de respuesta de sugerencias.
En el siguiente ejemplo, se muestra un mensaje de precios <Query> para la fecha de entrada.
intervalos:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<FirstDate>2023-05-23</FirstDate>
<LastDate>2023-05-26</LastDate>
<Nights>3</Nights>
<PropertyList>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</PropertyList>
</Query>
En este ejemplo, se solicitan actualizaciones de precios para las siguientes estadías (para cada hotel):
5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/24/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23
Estadías con rango
En el siguiente ejemplo, se muestra un mensaje <Query> de precios para intervalos
se queda:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<FirstDate>2023-05-23</FirstDate>
<LastDate>2023-05-26</LastDate>
<AffectedNights>3</AffectedNights>
<PropertyList>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</PropertyList>
</Query>
En este ejemplo, se solicitan actualizaciones de precios para cada hotel:
5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/25/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23
Además, las estadías que comenzaron antes (pero incluyen) la noche determinada:
5/20/23 - 5/23/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
Mensaje de consulta de metadatos
En el siguiente ejemplo, se muestra un mensaje <Query> que solicita metadatos.
actualizaciones de la información de habitaciones y paquetes de varias propiedades:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<HotelInfoProperties>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</HotelInfoProperties>
</Query>
Respondes a este tipo de mensaje de consulta con un mensaje de transacción que define los metadatos de habitaciones y paquetes. Para obtener más información, consulta Definición de metadatos de habitaciones y paquetes.