Mensagens de consulta são solicitações do Google para atualizações de preços ou metadados. Eles são usados com os métodos "Pull" e "Alterar preços" modos de transferência.
O elemento raiz das Mensagens de consulta é <Query>.
A estrutura da Mensagem de consulta depende do tipo de mensagem:
Preços: o Google envia uma Mensagem de consulta que solicita atualizações de preço para os hotéis especificados.
Metadados:o Google envia uma Mensagem de consulta que solicita dados sobre o quarto. e informações de pacote nos hotéis especificados.
Você define o endpoint que o Google usa para Mensagens de consulta e para transmissões ao vivo Consultas de preço durante a configuração inicial. Para mais informações, entre em contato com seu Gerente técnico de contas (TAM).
O Google envia uma Mensagem de consulta como uma solicitação POST HTTP com Content-Type.
cabeçalho definido como "application/xml" e o cabeçalho User-Agent definido como
Google-HotelAdsPrices. A exceção a essa regra ocorre durante o teste manual de
a integração do endpoint de preço pelo Google-TravelAds-Live. Essas amostras
consultas podem ou não conter o cabeçalho User-Agent.
A formatação detalhada para Mensagens de consulta pode ser encontrada no Referência XML de consultas.
Mensagens de consulta de preço
As Mensagens de consulta de preço especificam as combinações de propriedade ou itinerário para as quais você fornece os preços.
Quando seu servidor recebe uma Mensagem de consulta de preço, ele deve responder com uma
Mensagem <Transaction> que contém as informações de preço solicitadas.
Para mais informações, consulte Visão geral de preços.
Há três tipos especiais de Mensagens de consulta:
Preços em tempo real:se ativado, as consultas são enviadas quando um usuário está ativamente procurando preços para a combinação especificada de propriedade ou itinerário e têm um prazo para responder.
Com contexto:se ativada, as recomendações de contexto do usuário são incluídas. consultas que o Google envia a você e as recomendações refletem a maioria tipos comuns de usuários que pesquisam a propriedade ou o itinerário específico diferentes. Seguir essas recomendações pode aumentar a eficiência suas respostas.
Metadados: é uma solicitação de detalhes sobre quartos e pacotes do propriedades especificadas.
Consultas de preços em tempo real
As consultas de preço em tempo real são solicitações do Google para atualizações de preço em tempo real respostas às pesquisas dos usuários. O Google recebe uma solicitação de pesquisa de um usuário por um combinação de hotel ou itinerário e porque os dados de preços não estão disponíveis atual, o Google solicita uma atualização de preço no momento da pesquisa. Com Consulta de preços em tempo real, o Google tenta obter um preço e exibi-lo no resultados no momento da pesquisa.
Todas as solicitações de consulta de preço em tempo real têm um limite de tempo de resposta que normalmente é até 4.000 milissegundos. Esse limite é especificado na consulta de preço em tempo real solicitação. Se uma resposta não puder ser fornecida dentro do tempo limite, isso resultará em uma participação perdida para a oportunidade específica. No entanto, recomendamos fornecendo um preço mesmo assim para que ele possa ser armazenado em cache e usado em oportunidades futuras. A conexão para a resposta permanece aberta por dez minutos especificado na configuração do parceiro.
As consultas de preços em tempo real também são contextuais e podem recuperar os preços dos seguintes parâmetros: país do usuário, tipo de dispositivo, ocupação (número de convidados), e se esses hóspedes são adultos ou crianças. Com as consultas de preços em tempo real, pode mostrar preços mais atualizados que correspondam ao que o cliente pesquisou.
As consultas de preços em tempo real devem ser um mecanismo secundário de definição de preços atualizações. O principal mecanismo para mudanças de preço ainda é Pull ou Alterado preços. As consultas de preços em tempo real ajudam a preencher as lacunas quando o Google não tem preços para combinações de hotel ou itinerário.
Regras para usar consultas de preços em tempo real
Não há dados em cache para o itinerário especificado porque o itinerário solicitado for atípica, por exemplo, as datas estão muito distantes no futuro ou o hotel é muito pesquisado com pouca frequência.
A data solicitada não é padrão.
Observação: as datas padrão não são qualificadas para consultas de preço em tempo real. Disponível consultas de preços é solicitada apenas para datas não padrão.
Normalmente, o Google armazena em cache os resultados de um preço em tempo real para que o mesmo hotel ou itinerário não serão consultados novamente. Ele pode solicitar um único hotel ou itinerário bem como combinações de vários hotéis ou de um único itinerário.
O recurso Preços em tempo real com contexto permite que o Google envie preços específicos
Solicitações de preços em tempo real com base no tipo de dispositivo do usuário e no país de origem
que eles estão procurando e o número de moradores, incluindo crianças. Tanto o
A mensagem de consulta e a Mensagem de transação são expandidas para incluir o
O elemento <Context> que define os parâmetros de consulta. Preços recebidos de
As consultas de preço em tempo real com contexto podem ser armazenadas em cache como uma Categoria de quarto.
se for um preço para uma ocupação específica e como uma Tarifa condicional,
se for para o país ou dispositivo do usuário.
Com consultas de contexto
Com as consultas de contexto, são solicitações regulares para atualizar o banco de dados da propriedades ou itinerários especificados. Eles contêm uma lista de usuários contextos populares para essas combinações. Se As tarifas condicionais são usadas e o envio de taxas para todos os contextos de usuário possíveis pode ser caro, portanto você pode use essa lista de contextos do usuário para limitar sua resposta. Preços de devolução por apenas os contextos de usuário especificados abrange a grande maioria das consultas de usuário relevantes.
Mensagens de consulta de metadados
As mensagens de consulta de metadados contêm detalhes sobre informações de quartos e pacotes para as propriedades especificadas.
Quando você receber uma Mensagem de consulta de metadados, responda com
Uma mensagem <Transaction> que especifica o preço das propriedades solicitadas.
em elementos <Result>.
Para mais informações, consulte Definir metadados de quartos e pacotes.
Controlar consultas
Esta seção descreve como você controla quais propriedades e itinerários podem ser o assunto de Mensagens de consulta do Google.
Limites de itinerário
Você determina os possíveis limites das consultas de preço usando
<ItineraryCapabilities> Você define regras que determinam o intervalo de datas
e durações máximas de estadia que você aceita.
Você pode definir valores padrão para <MaxAdvancePurchase> e <MaxLengthOfStay>
que se aplicam a todas as combinações de hotéis ou itinerários. Também é possível definir
para grupos de hotéis.
Exemplos de mensagens de consulta
Esta seção mostra vários exemplos de Mensagens de consulta de preço e uma solicitação Mensagem de consulta. Confira outros exemplos na Referência XML de consultas.
Roteiro de exemplo
O exemplo a seguir mostra um <Query> de preços que solicita atualizações de preço
para quatro hotéis, disponível para três noites a partir de 23 de maio 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>
Este exemplo solicita atualizações de preços para cada hotel:
5/23/18 - 6/26/18
Exemplo de consulta de preço em tempo real
O exemplo a seguir mostra uma consulta de preço em tempo real com limite de tempo de resposta de 500 milissegundos:
<?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>
Este exemplo solicita o preço de um único hotel:
6/23/23 - 6/25/23
Um exemplo de resposta de mensagem de transação para essa consulta pode ser encontrado no Preços e Referência XML de inventário do Room (transações).
Com exemplo de consulta de contexto
Confira a seguir um exemplo com consulta de 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>
Com as consultas de contexto, apenas o contexto do país do usuário é especificado. No futuro, também podem especificar o dispositivo e a ocupação do usuário.
Períodos de check-in
Se você usar "Preço alterado", a estrutura da Mensagem de consulta dependerá no tipo de dica usado para períodos de check-in, valores exatos itinerários ou itinerários predeterminados. Para mais informações sobre cada um desses Tipos de dicas, consulte Mensagens de Hint Response.
O exemplo a seguir mostra uma mensagem de preço <Query> para a data do check-in
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>
Este exemplo solicita atualizações de preços para as seguintes estadias (de 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
Estadias predeterminadas
O exemplo a seguir mostra uma mensagem de preço <Query> para um intervalo
permanece:
<?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>
Este exemplo solicita atualizações de preços 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
Além de estadias iniciadas antes (mas incluindo) a noite em questão:
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
Mensagem de consulta de metadados
O exemplo a seguir mostra uma mensagem <Query> que solicita metadados
atualizações para as informações de quartos e pacotes para várias propriedades:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<HotelInfoProperties>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</HotelInfoProperties>
</Query>
Você responde a esse tipo de Mensagem de consulta com uma Mensagem de transação que define metadados de quartos e pacotes. Para mais informações, consulte Como definir metadados de quartos e pacotes.