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 especifica 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 mudanças nos preços, o Google vai 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ços, consulte a Visão geral de preços.

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

• Itinerários exatos
• Períodos de check-in
• Estadias por período

O elemento raiz de uma mensagem de resposta de dica é <Hint>. Você solicita a atualização de um hotel ou itinerário usando um ou mais elementos <Item>. 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 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, é possível instruir o Google a permitir vários hotéis em um bloco de itens se você estiver usando intervalos de datas de check-in ou estadias com intervalo para reprecificação.

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

As mensagens de sugestão 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 duração da estadia para seus hotéis, e o Google busca os novos dados de preços apenas para esse itinerário.

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

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

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 intervalo de datas de check-in, começando com a primeira e terminando com a última. Quando o Google busca novos dados de preços, ele extrai itinerários para todas as datas de check-in do hotel, começando por essas datas e se estendendo até a duração da estadia indicada.

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

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

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

Fluxo de solicitação e resposta de permanências em intervalos

Uma mensagem de resposta de dica pode incluir um intervalo 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.

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

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

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