Mensagens de resposta de dica

Quando o Google envia uma mensagem de Hint Request, seus servidores precisam responder com uma mensagem de Hint Response que especifique os hotéis com preços alterados desde a última vez em que o Google recebeu uma mensagem de Hint Response desses mesmos servidores. Se houver alguma mudança de preço, o Google vai enviar uma <Query> que busca os dados de preços atualizados para os hotéis e itinerários indicados.

Para saber mais sobre o processo de mudanças no preço, consulte Visão geral de preços.

As mensagens de Hint Response usam os seguintes métodos para atualizar os preços dos hotéis selecionados e dos itinerários deles:

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

Cada mensagem de Hint Response precisa especificar pelo menos um elemento <Property> para cada <Item>. O <Property> identifica um hotel usando os mesmos códigos da lista de hotéis. Por padrão, você especifica um único ID de hotel para cada bloco de <Item>. No entanto, você pode instruir o Google a permitir vários hotéis em um bloco de itens se estiver usando períodos de check-in ou estadias predeterminadas para mudanças de preço.

Solicitação de itinerário exato e fluxo de resposta

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

Resposta do parceiro

A mensagem de Hint Response 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 Hint Response 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, crie um <Transaction> com atualizações de preço do hotel para a seguinte estadia:

5/20/23 - 5/23/23

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

Uma mensagem de Hint Response pode especificar um período de datas de check-in, começando pela primeira data e terminando pela ú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 que você indicar.

Datas predeterminadas do parceiro

O exemplo a seguir para a mensagem de Hint Response define uma única propriedade com um intervalo 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 Hint Response com um <Query> semelhante a este:

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

Criar <Transaction>

Depois, crie uma <Transaction> com atualizações de preço para as seguintes estadias nesse 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

Nesse exemplo, a duração da estadia padrão é de cinco noites.

Fluxo de solicitações e respostas de estadias predeterminadas

Uma mensagem de Hint Response pode incluir um período que foi alterado. Isso informa ao Google que ele precisa buscar qualquer itinerário afetado por qualquer uma dessas 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 predeterminadas do parceiro

O exemplo de mensagem de Hint Response a seguir usa estadias predeterminadas:

<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 Hint Response 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>

Depois, crie um <Transaction> com atualizações de preço do hotel para as 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