I messaggi Transaction inviano a Google dati su camere, prezzi e pacchetti. Esistono due tipi principali di messaggi Transaction:
Dati di itinerario: definiscono i dati dell'itinerario e del pacchetto camera, tra cui:
Prezzi dell'hotel e inventario: imposta il prezzo minimo per un itinerario che soddisfa determinati requisiti. Per ulteriori informazioni, consulta la sezione Aggiornare i prezzi. Puoi anche rimuovere una camera dall'inventario. Per maggiori informazioni, consulta la sezione Rimuovere l'inventario.
Pacchetti camera: imposta i prezzi dell'itinerario per una combinazione di una camera fisica e un pacchetto di servizi aggiuntivi. Per ulteriori informazioni, consulta la pagina Pacchetti camera. Google memorizza nella cache i contenuti dei tuoi messaggi Transaction in modo che i prezzi siano sempre disponibili. In alcuni casi, Google stabilisce che i valori nella sua cache non sono aggiornati, quindi potrebbe inviare ulteriori messaggi
<Query>
(o, in alcuni casi, query sui prezzi in tempo reale) per ricevere i prezzi aggiornati. Questi dati in genere cambiano molto spesso. Per definire i prezzi e la disponibilità dei messaggi Transaction, utilizza<Result>
.
Metadati di camere e pacchetti: specificano i dettagli su 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 dai messaggi relativi ai prezzi, anziché includere informazioni ripetitive su camere e pacchetti in ogni singolo dispositivo. 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 100 MB.
Per esempi di messaggi Transaction che rispondono alle richieste di Google, consulta la pagina di riferimento sui file XML di prezzi e inventario delle camere (transazioni).
Modalità di invio
Il tipo e la frequenza con cui invii i messaggi Transaction dipendono dalla modalità di invio:
- Per la modalità di invio Pull, devi inviare i messaggi Transaction quando ricevi
un
<Query>
da Google. - Per la modalità di invio Prezzo modificato, devi inviare un messaggio Transaction
dopo aver ricevuto e risposto a un avviso
<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 richieste note come Query sui prezzi in tempo reale. Questi messaggi Query sono richieste di prezzi in risposta a una ricerca attuale. Se rispondi entro il periodo di tempo specificato, solitamente alcune centinaia di millisecondi, il tuo annuncio potrà comparire nell'asta. Inoltre, i tuoi risultati possono corrispondere meglio al cliente, inclusi paese e tipo di dispositivo, e numero di ospiti che ha specificato. Per ulteriori informazioni, consulta la sezione 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 ciascun messaggio non possono superare 100 MB. In genere, tutte le richieste Pull e Hint Request hanno un limite di tempo di risposta di 100 secondi. Il timeout è un campo configurabile da Google come richiesto. Google consiglia di impostare il timeout su 10 minuti per i messaggi di grandi dimensioni.
Per ridurre notevolmente le dimensioni dei messaggi ed evitare potenzialmente problemi relativi a
dimensioni e 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.