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