Panoramica dei messaggi Transaction

I messaggi Transaction inviano dati su camere, prezzi e pacchetti a Google. Esistono due tipi principali di messaggi Transaction:

  1. Dati dell'itinerario: definisci i dati del pacchetto camera e dell'itinerario, tra cui:

    • Prezzi dell'hotel e inventario: imposta il prezzo minimo per un itinerario che soddisfa determinati requisiti. Per maggiori informazioni, consulta la pagina Aggiornamento dei prezzi. Puoi anche rimuovere una stanza dall'inventario. Per ulteriori informazioni, consulta la sezione Rimuovere l'inventario.

    • Pacchetti camera: imposta i prezzi dell'itinerario per una combinazione di camera fisica e pacchetto di servizi aggiuntivi. Per maggiori informazioni, pacchetti camera. Google memorizza nella cache i contenuti dei messaggi Transaction in modo che i prezzi siano sempre disponibili. In alcuni casi, Google stabilisce che i valori nella cache non sono aggiornati, quindi potrebbe inviare ulteriori 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>.

  2. Metadati di camere e pacchetti: specifica i dettagli relativi a camere e pacchetti, come 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 consultarli nei messaggi sui prezzi, anziché includere informazioni ripetitive su camere e pacchetti in ognuno. Per ulteriori informazioni, consulta 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 qualsiasi 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 Riferimento XML per prezzi e inventario delle camere (messaggi Transaction).

Modalità di invio

Il tipo e la frequenza con cui invii messaggi Transaction dipendono dalla tua 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 dei prezzi modificati, devi inviare un messaggio Transaction dopo aver ricevuto e risposto a un messaggio <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 di query cercano i prezzi in risposta a una ricerca corrente. Se rispondi entro il periodo di tempo specificato, che di solito è di qualche centinaio di millisecondi, il tuo annuncio può partecipare all'asta. I risultati possono inoltre corrispondere meglio al cliente, ad esempio il paese e il tipo di dispositivo, nonché il numero di ospiti specificati. Per ulteriori informazioni, consulta la pagina Query sui prezzi in tempo reale.

Dimensioni messaggio

In un singolo messaggio Transaction puoi includere qualsiasi combinazione di aggiornamenti dei dati, ma esiste un limite di 100 MB per le dimensioni di ogni messaggio. In genere, tutte le richieste di pull e suggerimento hanno un tempo di risposta di 100 secondi. Il timeout è un campo configurabile regolabile da Google come richiesto. Per i messaggi di grandi dimensioni, Google consiglia di impostare un timeout di 10 minuti.

Per ridurre notevolmente le dimensioni del messaggio ed evitare potenzialmente problemi con le dimensioni dei messaggi e i timeout, 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.