Mensagens de resposta de dica

Quando o Google envia uma mensagem de solicitação de dica, seus servidores precisam responder com uma mensagem de Hint response message que especifica os hotéis cujos preços mudaram desde a última vez que o Google recebeu uma Hint response message bem-sucedida desses mesmos servidores. Se houver mudanças de preço, o Google então enviará um <Query> que busca os dados de preços atualizados dos hotéis e itinerários indicados.

Para uma visão geral do processo de mudança de preço, consulte a Visão geral de preços.

As mensagens de resposta de dica usam os seguintes métodos para mudar o preço dos hotéis selecionados e dos itinerários deles:

O elemento raiz de uma mensagem de resposta de dica é <Hint>. Para solicitar a atualização de um hotel ou itinerário, use um ou mais <Item> elementos. Uma única mensagem de resposta de dica pode definir qualquer número de elementos <Item>.

Cada mensagem de resposta de dica precisa especificar pelo menos um <Property> elemento para cada <Item>. O <Property> identifica um hotel usando os mesmos IDs da lista de hotéis. Por padrão, você especifica um único ID de hotel para cada <Item> bloco. No entanto, é possível instruir o Google a permitir vários hotéis em um bloco de itens se você estiver usando períodos de datas de check-in ou estadias variadas para mudar o preço.

Fluxo de solicitação e resposta de itinerário exato

As mensagens de dica podem ser baseadas em itinerários individuais, como a combinação de data do check-in e duração da estadia. Nesse caso, você especifica uma data do check-in e a duração da estadia dos seus hotéis, e o Google busca os novos dados de preços apenas para esse itinerário.

Resposta do parceiro

A mensagem de resposta de dica a seguir define uma única propriedade e um único itinerário:

<Hint>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2023-05-20</CheckInDate>
      <LengthOfStay>3</LengthOfStay>
    </Stay>
  </Item>
</Hint>

Resposta do Google

O Google responde à sua mensagem de resposta de dica com um <Query> semelhante ao seguinte:

<Query>
  <Checkin>2023-05-20</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

Criar <Transaction>

Em seguida, você precisa criar uma <Transaction> com atualizações de preços para o hotel na seguinte estadia:

5/20/23 - 5/23/23

Fluxo de solicitação e resposta de períodos de datas de check-in

Uma mensagem de resposta de dica pode especificar um período de datas de check-in, começando pela primeira e terminando na última. Quando o Google busca novos dados de preços, ele extrai itinerários para cada data de check-in do hotel, começando por essas datas e se estendendo até a duração da estadia indicada.

Datas variadas do parceiro

O exemplo a seguir de mensagem de resposta de dica define uma única propriedade com um período de datas para o check-in:

<Hint>
  <Item>
    <Property>12345</Property>
    <FirstDate>2023-05-20</FirstDate>
    <LastDate>2023-05-23</LastDate>
  </Item>
</Hint>

Resposta do Google

O Google responde a essa mensagem de resposta de dica com <Query> semelhante a isto:

<Query>
  <FirstDate>2023-05-20</FirstDate>
  <LastDate>2023-05-23</LastDate>
  <Nights>5</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

Criar <Transaction>

Em seguida, você precisa criar uma <Transaction> com atualizações de preços para as seguintes estadias desse 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

Este exemplo usa uma duração da estadia de 5 noites. A duração padrão da estadia é de 30 dias.

Fluxo de solicitação e resposta de estadias variadas

Uma mensagem de resposta de dica pode incluir um período de datas que mudaram. Isso informa ao Google que ele precisa buscar qualquer itinerário afetado por essas datas. O conjunto real de itinerários buscados é uma função do conjunto de datas com mudanças e da duração máxima da estadia.

Estadias variadas do parceiro

A mensagem de resposta de dica de exemplo a seguir usa estadias variadas:

<Hint>
  <Item>
    <Property>12345</Property>
    <StaysIncludingRange>
      <FirstDate>2023-05-20</FirstDate>
      <LastDate>2023-05-23</LastDate>
    </StaysIncludingRange>
  </Item>
</Hint>

Resposta do Google

O Google responde à sua mensagem de resposta de dica com um <Query> semelhante ao seguinte:

<Query>
  <FirstDate>2023-05-20</FirstDate>
  <LastDate>2023-05-23</LastDate>
  <AffectedNights>3</AffectedNights>
  <PropertyList>
    <Property>12345</Property>
    <Property>67891</Property>
  </PropertyList>
</Query>

Criar <Transaction>

Em seguida, você precisa criar uma <Transaction> com atualizações de preços para o hotel nas seguintes estadias:

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

Estadias variadas: limites de lote e divisão de consultas

O Google limita cada consulta de extração a um máximo de 10.000 combinações de pares de hotel e itinerário (um hotel, data de check-in e duração da estadia). Para uma dica de estadia variada, o número de combinações é calculado usando a fórmula do trapézio para calcular o número de combinações de pares de hotel e itinerário para consultas de estadias variadas:

$$ \text{Total Items} = \left( \text{Date Span} \times \text{LOS} + \frac{\text{LOS} \times (\text{LOS} + 1)}{2} \right) \times N_{\text{hotel_batch_size}} $$

Em que:

  • Date Span: o número inclusivo de dias entre <FirstDate> e <LastDate> (período = LastDate - FirstDate + 1).
  • LOS: a duração da estadia máxima solicitada na dica (por exemplo, <AffectedNights>14</AffectedNights>).
  • \(N_{\text{hotel_batch_size}}\): o número de propriedades incluídas no lote de consultas (configurado por hotel_batch_size).

O que acontece quando uma dica excede 10.000 itens?

Se os itens calculados excederem 10.000, o Google vai dividir automaticamente a carga de trabalho da consulta:

  1. Tentativa inicial (estadia variada): um período de datas menor que abrange o início do seu período é enviado usando <AffectedNights>.
  2. Primeira alternativa (se compatível: período de check-in): vamos tentar enviar os restantes menores do seu período de datas como consultas de período de datas de check-in usando <Nights> (consulta abaixo).
  3. Alternativa final (itinerários exatos): vamos voltar a expandir o conjunto de consultas para os itinerários exatos individuais.
<!-- Example: Remainder batch dispatched after a split -->
<Query>
  <FirstDate>2026-10-01</FirstDate>
  <LastDate>2026-10-31</LastDate>
  <Nights>14</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>
  • Mantenha os tamanhos dos lotes de propriedades equilibrados: se você atualizar grandes períodos de datas (como 180 a 365 dias) com durações de estadia de 14 noites ou mais, peça ao gerente técnico de contas do Google para definir o hotel_batch_size como um valor menor para evitar que as dicas acionem divisões.
  • Restrinja as dicas: ao notificar o Google sobre mudanças de preço, restrinja os períodos <FirstDate> e <LastDate> aos intervalos de datas específicos em que as tarifas realmente mudaram, em vez de enviar um ano civil completo.
  • Se as dicas abrangem grandes períodos de datas: verifique se o analisador aceita ou em blocos que contêm <FirstDate> e <LastDate>, para que vários tipos de consultas variadas possam ser usados para atender às solicitações de extração.