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 uma <Query> que vai buscar os dados de preços atualizados dos hotéis e itinerários indicados.
Para ter uma visão geral do processo de reprecificação, consulte a Visão geral de preços.
As mensagens de resposta de dicas usam os seguintes métodos para reajustar o preço dos hotéis selecionados e os itinerários deles:
O elemento raiz de uma mensagem de resposta de dica é <Hint>. Você solicita que um hotel ou itinerário seja atualizado usando um ou mais elementos <Item>. Uma única mensagem de resposta
de sugestão 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 para reajustar o preço.
Fluxo de solicitação e resposta de itinerário exato
As mensagens de sugestão 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 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 resposta de sugestão 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 resposta de dica 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 uma <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 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 cada data de check-in do hotel, começando por essas datas e estendendo-se até a duração da estadia que você indicar.
Datas de início e término do parceiro
O exemplo a seguir para a mensagem de resposta de sugestão 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>
Em seguida, crie uma <Transaction> com atualizações de preço
para as seguintes estadias no 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
Este exemplo usa uma duração de 5 noites. A duração padrão da estadia é de 30 dias.
Fluxo de solicitação e resposta de estadias com intervalos
Uma mensagem de resposta de dica 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 com intervalos do parceiro
O exemplo de mensagem de resposta de dica a seguir usa estadias com intervalos:
<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 resposta de dica 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 uma <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