I messaggi Transaction inviano i dati su camere, prezzi e pacchetti a Google. Esistono due tipi principali di messaggi Transaction:
Dati dell'itinerario: definiscono i dati del pacchetto camera e dell'itinerario, tra cui:
Prezzi e inventario dell'hotel: consentono di impostare il prezzo minimo per un itinerario che soddisfa determinati requisiti. Per maggiori informazioni, consulta la sezione Aggiornare i prezzi. Puoi anche rimuovere una camera dall'inventario. Per maggiori informazioni, consulta Rimuovere l'inventario.
Pacchetti camera: stabiliscono i prezzi dell'itinerario per una combinazione di una camera fisica e un pacchetto di servizi aggiuntivi. Per ulteriori informazioni, consulta la sezione Pacchetti camera. Google memorizza nella cache i contenuti dei messaggi Transaction in modo che i prezzi siano sempre disponibili. In alcuni casi, Google determina che i valori nella sua cache non sono aggiornati, quindi potrebbe inviare altri messaggi
<Query>(o, in alcuni casi, query sui prezzi in tempo reale) per ottenere i prezzi aggiornati. In genere questi dati cambiano molto spesso. Per definire i prezzi e la disponibilità dei messaggi Transaction, utilizza<Result>.
Metadati di camere e pacchetti: specifica i dettagli di camere e pacchetti, ad esempio descrizioni, foto e numero massimo di persone. Questi dati non cambiano molto spesso. Per definire i messaggi Transaction dei metadati, utilizza
<PropertyDataSet>. Google archivia questi metadati in modo che tu possa farvi riferimento nei messaggi sui prezzi anziché includere informazioni ripetitive su camere e pacchetti in ogni messaggio. Per ulteriori informazioni, consulta la sezione Definire i metadati di camere e pacchetti.
L'elemento principale di un messaggio Transaction è <Transaction>. I messaggi che utilizzano
l'elemento <Transaction> come elemento principale richiedono almeno uno
degli elementi secondari. I messaggi Transaction possono avere un numero illimitato di elementi secondari, a condizione che le dimensioni totali del messaggio non superino i 100 MB.
Per esempi di messaggi Transaction che rispondono alle richieste di Google, consulta la sezione Riferimento XML per prezzi e inventario delle camere (messaggi Transaction).
Modalità di invio
Il tipo e la frequenza con cui invii i messaggi Transaction dipendono dalla modalità di recapito:
- Per la modalità di invio Pull, devi inviare i messaggi Transaction quando ricevi
una
<Query>da Google. - Per la modalità di invio Prezzo modificato, devi inviare un messaggio Transaction
dopo aver ricevuto e risposto ai messaggi
<HintRequest>e<Query>.
Per ulteriori informazioni, consulta la sezione Modalità di invio dei prezzi.
Query sui prezzi in tempo reale
Indipendentemente dalla modalità di invio, Google potrebbe anche inviarti delle richieste note come query sui prezzi in tempo reale. Questi messaggi Query cercano prezzi in risposta a una ricerca corrente. Se rispondi entro il periodo di tempo specificato, che solitamente è di alcune centinaia di millisecondi, il tuo annuncio può apparire nell'asta. I risultati possono anche corrispondere meglio al cliente, tra cui il suo paese e il tipo di dispositivo e il numero di ospiti che ha specificato. Per maggiori informazioni, consulta Query sui prezzi in tempo reale.
Dimensioni messaggio
Puoi includere qualsiasi combinazione di aggiornamenti dei dati in un singolo messaggio Transaction, ma le dimensioni di ogni messaggio prevedono un limite di 100 MB. In genere, tutte le richieste Pull e Suggerimento hanno un limite di tempo di risposta di 100 secondi. Il timeout è un campo configurabile da Google come richiesto. Per i messaggi molto grandi, Google consiglia di impostare il timeout su 10 minuti.
Per ridurre notevolmente le dimensioni dei messaggi ed evitare potenzialmente problemi con le dimensioni e i timeout dei messaggi, utilizza i messaggi Transaction per predefinire i
metadati di camere e pacchetti.
Puoi anche aggiungere contenuti compressi GNU ai messaggi aggiungendo Content-Encoding: gzip alle intestazioni dei messaggi.