Mensagens de resposta de dica

Quando o Google envia uma mensagem de solicitação de Hint, seus servidores respondem com uma mensagem de Hint Response que especifica os hotéis que tiveram alterações desde a última vez que o Google recebeu uma resposta bem-sucedida desses mesmos servidores. Se houver alguma mudança de preço, o Google vai enviar um <Query> que busca os dados de preço atualizados para os hotéis e itinerários indicados.

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

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

O elemento raiz de uma mensagem de Hint Response é <Hint>. Você solicita a atualização de um hotel ou itinerário usando um ou mais elementos <Item>. 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 IDs 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 a mudança 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 do check-in e duração da estadia. Nesse caso, você especifica uma data de check-in e a duração da estadia dos 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 de Hint Response com um <Query> semelhante a este:

<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ços para o hotel na 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 intervalo de datas de check-in, começando pela data do primeiro e terminando com a última. Quando o Google busca novos dados de preços, ele extrai itinerários para cada data de check-in no hotel, começando com essas datas e estendendo-se até a duração da estadia que você indicar.

Períodos do parceiro

O exemplo a seguir de 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 <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>

Em seguida, crie um <Transaction> com atualizações de preços 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

Neste exemplo, usamos a duração da estadia padrão de cinco noites.

Fluxo de solicitação e resposta de estadias predeterminadas

Uma mensagem de Hint Response pode incluir um intervalo de datas que foram alteradas. 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 alterações e da duração máxima da estadia.

Estadias predeterminadas do parceiro

O seguinte exemplo de Mensagem de Hint Response 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 de Hint Response com um <Query> semelhante a este:

<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, crie um <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