Mensagens de resposta de dica

Quando o Google envia uma solicitação de dica padrão, seus servidores deve responder com uma mensagem de Hint Response que especifique os hotéis cujos os preços mudaram desde a última vez que o Google recebeu uma dica Resposta 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 da estadia dos seus hotéis, e o Google busca os novos dados de preço para apenas 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 seguinte:

<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 esta mensagem de Hint Response com <Query> semelhante a o seguinte:

<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 é necessário buscar qualquer itinerário afetado por qualquer um desses 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 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>

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