Quando Google invia una richiesta Hint
, i tuoi server
deve rispondere con un messaggio Hint Response che specifica gli hotel la cui
I prezzi sono cambiati dall'ultima volta che Google ha ricevuto correttamente un Hint
Risposta dagli stessi server. In caso di variazioni di prezzo, Google
invia un elemento <Query>
che recupera i dati sui prezzi aggiornati per l'attributo
hotel e itinerari.
Per una panoramica del processo di ricalcolo dei prezzi, consulta Panoramica dei prezzi.
I messaggi Hint Response utilizzano i seguenti metodi per ridefinire il prezzo degli hotel selezionati e i relativi itinerari:
di Gemini Advanced.L'elemento principale di un messaggio Hint Response è <Hint>
. Richiedi un hotel o
itinerario da aggiornare utilizzando uno o più elementi <Item>
. Un singolo suggerimento
Il messaggio di risposta può definire un numero illimitato di elementi <Item>
.
Ogni messaggio Hint Response deve specificare almeno un elemento <Property>
per ogni <Item>
. Il <Property>
identifica un hotel utilizzando gli stessi ID presenti
nell'elenco hotel. Per impostazione predefinita, devi specificare un singolo ID hotel per ogni <Item>
bloccare. Tuttavia, puoi chiedere a Google di consentire più hotel in un elemento
se utilizzi intervalli di date di check-in o soggiorni con intervallo di date per il ricalcolo del prezzo.
Flusso di richiesta e risposta dell'itinerario esatto
I messaggi Hint possono essere basati su singoli itinerari, ad esempio la combinazione di data del check-in e durata del soggiorno. In questo caso, devi specificare una data di check-in e la durata del soggiorno per i tuoi hotel e Google recupera i nuovi dati sui prezzi dell'itinerario.
Risposta del partner
Il seguente messaggio Hint Response definisce una singola proprietà e una singola itinerario:
<Hint>
<Item>
<Property>12345</Property>
<Stay>
<CheckInDate>2023-05-20</CheckInDate>
<LengthOfStay>3</LengthOfStay>
</Stay>
</Item>
</Hint>
Risposta di Google
Google risponde al tuo messaggio Hint Response con un elemento <Query>
simile al
seguenti:
<Query>
<Checkin>2023-05-20</Checkin>
<Nights>3</Nights>
<PropertyList>
<Property>12345</Property>
</PropertyList>
</Query>
Crea <Transaction>
Dovrai quindi creare una <Transaction>
con gli aggiornamenti dei prezzi per
hotel per il seguente soggiorno:
5/20/23 - 5/23/23
Flusso di richiesta e risposta per gli intervalli di date di check-in
Un messaggio Hint Response può specificare un intervallo di date di check-in, iniziando con dalla prima data del check-in e termina con l'ultima data del check-in. Quando Google recupera nuovi dati sui prezzi, Google estrae itinerari per ogni data di check-in l'hotel a partire da quelle date e si estende fino alla durata del soggiorno che da te indicato.
Date comprese del partner
L'esempio seguente di messaggio Hint Response definisce una singola proprietà con un intervallo di date per il check-in:
<Hint>
<Item>
<Property>12345</Property>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
</Item>
</Hint>
Risposta di Google
Google risponde a questo messaggio Hint Response con un elemento <Query>
simile al
seguente:
<Query>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
<Nights>5</Nights>
<PropertyList>
<Property>12345</Property>
</PropertyList>
</Query>
Crea <Transaction>
Dovrai quindi creare una <Transaction>
con gli aggiornamenti dei prezzi.
per i seguenti soggiorni dell'hotel in questione:
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
In questo esempio viene utilizzata la durata predefinita del soggiorno di 5 notti.
Flusso di richiesta e risposta dei soggiorni con intervallo
Un messaggio Hint Response può includere un intervallo di date che sono cambiate. Ciò permette a Google di sapere che deve recuperare qualsiasi itinerario interessato da una di queste date. L'insieme effettivo di itinerari recuperati è una funzione di entrambi gli insiemi date con modifiche e la durata massima del soggiorno.
Soggiorni con intervallo di date del partner
Il seguente messaggio Hint Response di esempio utilizza soggiorni con intervallo di date:
<Hint>
<Item>
<Property>12345</Property>
<StaysIncludingRange>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
</StaysIncludingRange>
</Item>
</Hint>
Risposta di Google
Google risponde al tuo messaggio Hint Response con un elemento <Query>
simile al
seguenti:
<Query>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
<AffectedNights>3</AffectedNights>
<PropertyList>
<Property>12345</Property>
<Property>67891</Property>
</PropertyList>
</Query>
Crea <Transaction>
Dovrai quindi creare una <Transaction>
con gli aggiornamenti dei prezzi per
hotel per i seguenti soggiorni:
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