I messaggi Query sono richieste di aggiornamenti di prezzi o metadati inviate da Google. Loro vengono utilizzati sia con i prezzi pull che con quelli modificati modalità di invio.
L'elemento principale dei messaggi Query è <Query>.
La struttura del messaggio Query dipende dal tipo di messaggio:
Prezzi:Google invia un messaggio Query in cui vengono richiesti gli aggiornamenti sui prezzi gli hotel specificati.
Metadati:Google invia un messaggio Query in cui vengono richiesti i dati relativi alla stanza e sui pacchetti negli hotel specificati.
Sei tu a definire l'endpoint utilizzato da Google per i messaggi Query e Live Query sui prezzi durante la configurazione iniziale. Per ulteriori informazioni, contatta il tuo Technical Account Manager (TAM).
Google invia un messaggio Query come richiesta POST HTTP con Content-Type
intestazione impostata su "application/xml" e l'intestazione User-Agent impostata su
Google-HotelAdsPrices. L'eccezione a questa regola si verifica durante la prova manuale
l'integrazione dell'endpoint di prezzo tramite Google-TravelAds-Live. Questi campioni
possono contenere o meno l'intestazione User-Agent.
La formattazione dettagliata dei messaggi Query è disponibile nella Riferimento XML per le query.
Messaggi relativi alle query sui prezzi
I messaggi Query sui prezzi specificano le combinazioni di proprietà o itinerari per cui tu fornisci i prezzi.
Quando riceve un messaggio Query sui prezzi, il server deve rispondere con un
Messaggio <Transaction> contenente le informazioni sui prezzi richieste.
Per ulteriori informazioni, consulta la Panoramica dei prezzi.
Esistono tre tipi speciali di messaggi Query:
Prezzi in tempo reale: se questa opzione è attiva, le query vengono inviate quando un utente sta attivamente. sfogliare i prezzi per la combinazione di proprietà o itinerario specificata e hanno un periodo di tempo specifico per rispondere.
Con contesto: se questa opzione è attiva, i suggerimenti relativi al contesto dell'utente sono inclusi in ogni query che Google ti invia e i consigli riflettono tipi comuni di utenti che cercano la proprietà o l'itinerario in questione combinazioni. Seguire questi consigli può aumentare l'efficienza le tue risposte.
Metadati: si tratta di una richiesta di dettagli su camere e pacchetti per il proprietà specificate.
Query sui prezzi in tempo reale
Le query sui prezzi in tempo reale sono richieste di aggiornamenti dei prezzi in tempo reale da parte di Google risposta alle ricerche degli utenti. Google riceve una richiesta di ricerca da un utente per combinazione di hotel o itinerario e perché i dati sui prezzi non sono disponibili o meno corrente, Google ti richiede un aggiornamento del prezzo al momento della ricerca. Con Query sui prezzi in tempo reale, Google tenta di ottenere un prezzo e mostrarlo risultati al momento della ricerca.
Tutte le richieste di query sui prezzi in tempo reale hanno un limite per il tempo di risposta, che in genere è fino a 4000 ms. Questo limite è specificato nella query sui prezzi in tempo reale richiesta. Se non è possibile fornire una risposta entro il limite di tempo, una mancata partecipazione per l'opportunità specifica. Tuttavia, ti consigliamo fornendo comunque un prezzo in modo che possa essere memorizzato nella cache e utilizzato per opportunità future. La connessione per la risposta rimane aperta per dieci minuti o specificato nella configurazione del partner.
Anche le query sui prezzi in tempo reale sono contestuali e possono recuperare i prezzi per i seguenti parametri: paese dell'utente, tipo di dispositivo, occupazione (numero di ospiti), e se questi ospiti sono adulti o bambini. Con le query sui prezzi in tempo reale, possono mostrare prezzi più aggiornati che corrispondono a ciò che il cliente ha cercato.
Le query sui prezzi in tempo reale sono intese come meccanismo secondario di determinazione dei prezzi aggiornamenti. Il meccanismo principale per il ricalcolo dei prezzi è ancora tramite pull o modificato i prezzi. Le query sui prezzi in tempo reale permettono a Google di colmare le lacune prezzi per le combinazioni di hotel o itinerario.
Regole per l'utilizzo di query sui prezzi in tempo reale
Non esistono dati memorizzati nella cache per l'itinerario in questione perché l'itinerario richiesto è atipica, ad esempio le date sono molto lontane nel futuro o l'hotel è molto cercati raramente.
La data richiesta non è una data predefinita.
Nota: le date predefinite non sono idonee per le query sui prezzi in tempo reale. Attivo Le query sui prezzi vengono richieste solo per le date non predefinite.
In genere Google memorizza nella cache i risultati di un prezzo in tempo reale in modo che lo stesso hotel o non vengono più interrogate. Può richiedere un singolo hotel o un singolo itinerario e combinazioni di più hotel o di un singolo itinerario.
La funzionalità Prezzi in tempo reale con contesto consente a Google di inviare
Richieste di prezzi in tempo reale in base al tipo di dispositivo di un utente, il paese da cui
che cercano e il numero di persone che abitano, inclusi i bambini. Entrambi i campi
Il messaggio Query e il messaggio Transaction sono espansi per includere
Elemento <Context> che definisce i parametri di query. Prezzi ricevuti da
Le query sui prezzi in tempo reale con contesto possono essere memorizzate nella cache come pacchetto camera,
se si tratta di un prezzo per un numero di persone specifico e come tariffa agevolata,
se è per il paese o il dispositivo dell'utente.
Con query di contesto
Le query di contesto sono richieste regolari di aggiornamento del database per combinazioni di proprietà o itinerario specificate. Contengono un elenco di contesti popolari per queste combinazioni. Se Viene utilizzata la tariffa agevolata: le tariffe di invio per tutti i possibili contesti utente possono essere costose, quindi utilizza questo elenco di contesti utente per limitare la risposta. Prezzi di ritorno solo per i contesti utente specificati coprono la maggior parte delle query pertinenti degli utenti.
Messaggi di query sui metadati
I messaggi di query sui metadati contengono dettagli sulle informazioni su camere e pacchetti per le proprietà specificate.
Quando ricevi un messaggio Query sui metadati, devi rispondere con
un messaggio <Transaction> che specifica i prezzi per le proprietà richieste
in elementi <Result>.
Per ulteriori informazioni, consulta la sezione Definire i metadati di camere e pacchetti.
Controlla le query
Questa sezione descrive come puoi controllare quali proprietà e itinerari può essere l'oggetto di messaggi Query di Google.
Confini degli itinerari
Sei tu a stabilire i possibili limiti delle query sui prezzi utilizzando
<ItineraryCapabilities> Sei tu a definire le regole che determinano l'intervallo di date
e le durate massime del soggiorno supportate.
Puoi impostare valori predefiniti per <MaxAdvancePurchase> e <MaxLengthOfStay>
che si applicano a tutte le combinazioni di hotel o itinerario. Puoi anche definire questi
impostazioni per gruppi di hotel.
Esempi di messaggi di query
Questa sezione mostra diversi esempi di messaggi Query sui prezzi e un Messaggio query. Ulteriori esempi sono disponibili nella Riferimento XML per le query.
Itinerario di esempio
L'esempio seguente mostra un prezzo <Query> che richiede gli aggiornamenti di prezzo
per 4 hotel, disponibile per 3 notti, a partire dal 23 maggio 2023:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<Checkin>2023-05-23</Checkin>
<Nights>3</Nights>
<PropertyList>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</PropertyList>
</Query>
In questo esempio vengono richiesti gli aggiornamenti dei prezzi per ogni hotel:
5/23/18 - 6/26/18
Esempio di query sui prezzi in tempo reale
L'esempio seguente mostra una query sui prezzi in tempo reale con un limite di tempo di risposta di 500 millisecondi:
<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<!-- Note that the latencySensitive attribute is not present by default but can
be configured to be displayed, on request, by Google. This attribute is only
displayed for a Live Pricing Query request -->
<Checkin>2023-05-23</Checkin>
<Nights>2</Nights>
<DeadlineMs>500</DeadlineMs>
<!-- The deadline represents the timeframe by which a response will need to be
received by. This element is only displayed for a Live Pricing Query request -->
<PropertyList>
<Property>6781291</Property>
</PropertyList>
<!-- Note that Context tags are potentially repeatable -->
<Context>
<!-- The total number of guests occupying the room (adults+children) -->
<Occupancy>3</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
<!-- In this example one of the 3 guests is a 5yr old child -->
<Children>
<Child age="5"/>
</Children>
</OccupancyDetails>
<!-- The user was located in the US when this search was made -->
<UserCountry>US</UserCountry>
<!-- The user was searching from a mobile device at the time of search -->
<UserDevice>mobile</UserDevice>
</Context>
</Query>
In questo esempio viene richiesto un prezzo per un singolo hotel:
6/23/23 - 6/25/23
Un esempio di risposta a questa query è disponibile nel Prezzi e Riferimento XML per l'inventario delle camere (Transazioni).
Esempio di query con contesto
L'esempio seguente mostra un esempio di query con contesto:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<Checkin>2023-05-23</Checkin>
<Nights>2</Nights>
<PropertyContextList>
<PropertyContext>
<Property>8675309</Property>
<!-- In the future, occupancy and device might be specified -->
<Context><UserCountry>US</UserCountry></Context>
<Context><UserCountry>GB</UserCountry></Context>
</PropertyContext>
<PropertyContext>
<Property>8675310</Property>
<Property>8675311</Property>
<Context><UserCountry>CA</UserCountry></Context>
</PropertyContext>
</PropertyContextList>
</Query>
Con le query di contesto, puoi specificare solo il contesto del paese dell'utente. In futuro, ad esempio, le query potrebbero anche specificare il dispositivo e il numero di persone dell'utente.
Intervalli di date di check-in
Se utilizzi Prezzo modificato, la struttura del messaggio Query dipenderà sul tipo di suggerimento che utilizzi per gli intervalli di date di check-in, o gli itinerari con intervallo di date. Per ulteriori informazioni su ciascuno di questi per i tipi di suggerimenti, consulta Messaggi Hint Response.
L'esempio seguente mostra un messaggio <Query> sui prezzi per la data del check-in
intervalli:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<FirstDate>2023-05-23</FirstDate>
<LastDate>2023-05-26</LastDate>
<Nights>3</Nights>
<PropertyList>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</PropertyList>
</Query>
In questo esempio vengono richiesti gli aggiornamenti dei prezzi dei seguenti soggiorni (per ogni hotel):
5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/24/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23
Soggiorni con intervallo di date
L'esempio seguente mostra un messaggio <Query> relativo ai prezzi per un intervallo di date
soggiorni:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<FirstDate>2023-05-23</FirstDate>
<LastDate>2023-05-26</LastDate>
<AffectedNights>3</AffectedNights>
<PropertyList>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</PropertyList>
</Query>
In questo esempio vengono richiesti gli aggiornamenti dei prezzi per ogni hotel:
5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/25/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23
Più i soggiorni che sono iniziati prima della notte specificata (che è inclusa):
5/20/23 - 5/23/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
Messaggio query sui metadati
L'esempio seguente mostra un messaggio <Query> che richiede i metadati
Aggiornamenti delle informazioni su camere e pacchetti di diverse strutture:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<HotelInfoProperties>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</HotelInfoProperties>
</Query>
Devi rispondere a questo tipo di messaggio Query con un messaggio Transaction che definisce i metadati di camere e pacchetti. Per ulteriori informazioni, vedi Definizione dei metadati di camere e pacchetti.