Mensagens de resposta de dica

Quando o Google envia uma mensagem de solicitação de dica, seus servidores precisam responder com uma mensagem de resposta de dica que especifique os hotéis cujos preços mudaram desde a última vez que o Google recebeu uma resposta de dica bem-sucedida desses mesmos servidores. Se houver alguma mudança de preço, o Google envia um <Query> que busca os dados de preço atualizados para o hotéis e itinerários.

Para ter uma visão geral do processo de reformulação de preços, consulte a 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 itinerários:

.

O elemento raiz de uma mensagem de Hint Response é <Hint>. Você solicita um hotel ou itinerário seja atualizado usando um ou mais elementos <Item>. Uma única dica A mensagem de resposta pode definir qualquer número de elementos <Item>.

Cada mensagem de Hint Response deve especificar pelo menos um elemento <Property> para cada <Item>. O <Property> identifica um hotel usando os mesmos IDs que Lista de hotéis. Por padrão, você especifica um único ID de hotel para cada <Item> bloco de recursos dependente. No entanto, você pode instruir o Google a permitir vários hotéis em um item bloquear se você estiver usando períodos de check-in ou estadias predeterminadas para mudança de preço.

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

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

Resposta do parceiro

A mensagem de Hint Response a seguir define uma única propriedade e uma única 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 ao seguintes:

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

Criar <Transaction>

Espera-se que você crie um <Transaction> com atualizações de preços para o 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 intervalo de datas de check-in, começando com na primeira data de check-in e terminando na última. Quando o Google busca novos dados de preço, o Google extrai itinerários para cada data de check-in para o hotel, começando por essas datas e estendendo-se até a duração da estadia que que você indicar.

Períodos do parceiro

O exemplo de mensagem de Hint Response a seguir 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 resposta de sugestão com <Query> semelhante a esta:

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

Criar <Transaction>

Espera-se que você 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 a 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 ao seguintes:

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

Espera-se que você crie um <Transaction> com atualizações de preços para o 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