Esta página foi traduzida pela API Cloud Translation.

Mensagens de consulta

As mensagens de consulta são solicitações do Google para atualizações de preços ou metadados. Eles são usados com os modos de envio de preços pull e alterados.

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 do pacote nos hotéis especificados.

Você define o endpoint que o Google usa para mensagens de consulta e consultas de preços em tempo real 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 HTTP POST com o cabeçalho Content-Type 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ços

As mensagens de consulta de preços especificam as combinações de propriedade e 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 ativada, as consultas são enviadas quando um usuário está pesquisando preços da propriedade ou da combinação de itinerários especificada, e você tem um período especificado 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: esta é uma solicitação de detalhes sobre quartos e pacotes das propriedades especificadas.

Consultas de preços em tempo real

As consultas de preços em tempo real são solicitações do Google para atualizações de preços em tempo real em resposta às pesquisas do usuário. O Google recebe uma solicitação de pesquisa de um usuário para uma combinação de hotel ou itinerário. Como os dados de preços não estão disponíveis ou não estão atualizados, o Google solicita uma atualização de preço no momento da pesquisa. Com a consulta de preços em tempo real, o Google tenta encontrar um preço e exibi-lo nos 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 solicitação de consulta de preços em tempo real. Se não for possível enviar uma resposta dentro do prazo, a participação na oportunidade específica será perdida. No entanto, recomendamos fornecer um preço para que ele possa ser armazenado em cache e usado para 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 preços para os seguintes parâmetros: país do usuário, tipo de dispositivo, ocupação (número de hóspedes) e se os hóspedes são adultos ou crianças. Com as consultas de preços em tempo real, você pode mostrar preços mais atualizados que correspondem ao que o cliente pesquisou.

As consultas de preços em tempo real são um mecanismo secundário para atualizações de preços. O mecanismo principal para reavaliação ainda é por meio de preços de puxar ou alterados. As consultas de preços em tempo real ajudam a preencher as lacunas em que 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. As consultas de preços em tempo real são solicitadas apenas para datas que não são padrão.

O Google normalmente armazena em cache os resultados de um preço em tempo real para que o mesmo hotel ou itinerário não seja consultado 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 ao vivo com contexto permite que o Google envie solicitações específicas de preços ao vivo com base no tipo de dispositivo do usuário, no país em que ele está fazendo a pesquisa e no número de ocupantes, 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. Os preços recebidos de consultas de preços em tempo real com contexto podem ser armazenados em cache como um pacote de quartos, se for um preço para uma ocupação específica, e como uma tarifa condicional, se for para um país ou dispositivo do usuário.

Com consultas de contexto

Com as consultas de contexto, são solicitações regulares para atualizar nosso banco de dados com as combinações de itinerário ou propriedade especificadas. Eles contêm uma lista de usuários contextos populares para essas combinações. Se As tarifas condicionais são usadas e as taxas de envio para todos os contextos de usuário possíveis podem ser caras, portanto, 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.

Se você tiver interesse em receber consultas com o contexto, entre em contato com seu Gerente de contas (TAM). Ele pode confirmar se você está pronto para receber esses e, em seguida, fazer um ajuste de configuração para começar a enviar contextos ao usuário. em consultas para você.

Mensagens de consulta de metadados

As mensagens de consulta de metadados contêm detalhes sobre as informações de quarto e pacote das propriedades especificadas.

Quando você receber uma mensagem de consulta de metadados, responda com uma mensagem <Transaction> que especifique o preço das propriedades solicitadas nos elementos <Result>.

Para mais informações, consulte Como definir metadados de sala e pacote.

Controlar consultas

Esta seção descreve como controlar quais propriedades e itinerários podem ser o assunto das 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ços e uma mensagem de consulta de metadados. Outros exemplos estão disponíveis na Referência de consulta XML.

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

O exemplo a seguir mostra uma consulta com 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 intervalos de datas de check-in:

<?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 em intervalos

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

Estadias Plus iniciadas antes (mas que incluem) 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 atualizações de metadados para as informações de sala e pacote de 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>

Responda a esse tipo de mensagem de consulta com uma mensagem de transação que define os metadados do quarto e do pacote. Para mais informações, consulte Como definir metadados de sala e pacote.