Metodo di consegna push per i prezzi degli hotel

Nota: Google supporta Push per un insieme limitato di casi d'uso e partner. Questo documento è destinato ai partner esistenti che attualmente utilizzano Push e ai nuovi partner che rispettano le rigorose linee guida di Google per l'utilizzo di Push.

Se hai limitazioni di sistema che ti impediscono di supportare i metodi di invio Pull o Pull with Hints, utilizza il modulo Contattaci.

Panoramica della modalità di invio Push

Con la modalità di invio Push, invii aggiornamenti incrementali ogni volta che i prezzi o la disponibilità cambiano.

La seguente immagine mostra il flusso di richiesta/risposta per la modalità di invio Push:

Nota: prima di poter utilizzare Push per inviare aggiornamenti dei prezzi a Google, devi disporre degli indirizzi IP del tuo server nella lista consentita, come descritto di seguito.

Configurazione del push del file di configurazione del protocollo

Per aggiornare i prezzi con la modalità di invio Push, specifica i seguenti elementi nel file di configurazione del protocollo. Puoi farlo solo quando configuri l'ambiente per la prima volta per utilizzare l'API Hotel Price:

• <Model>: imposta il valore dell'elemento <Model> su "push".
• <WhitelistedIPs>: elenca i tuoi indirizzi IP che utilizzi per autenticare la comunicazione tra te e Google. Il valore di questo elemento può essere un elenco separato da punto e virgola dei tuoi indirizzi IP oppure un intervallo di indirizzi IP con notazione CIDR. Il formato è xxx.xxx.xxx.xxx/YY.

L'esempio seguente mostra un file di configurazione del protocollo per i partner che utilizzano Push:

<?xml version="1.0" encoding="UTF-8"?>
<Configuration>
  <Model>push</Model>
  <WhiteListedIPs>216.239.32.0/19;64.233.160.0/19</WhiteListedIPs>
</Configuration>

Per ulteriori informazioni, consulta il file di configurazione del protocollo.

Aggiornamento dei prezzi con Push

Per aggiornare i dati con la modalità Push, invia un messaggio Transaction ogni volta che i dati cambiano.

Attieniti alle linee guida seguenti quando invii il messaggio Transaction:

• Invia il messaggio al seguente endpoint:
  • http://www.google.com/travel/hotels/uploads/price
• Utilizzare il metodo HTTP POST.
• Imposta l'intestazione Content-Type su "application/xml".
• Il corpo del messaggio deve essere conforme alla sintassi del messaggio Transaction, come descritto in Impostare i prezzi (per gli aggiornamenti dei prezzi) o in Definire i metadati di camere e pacchetti (per gli aggiornamenti dei metadati).
• Per gli aggiornamenti dei prezzi, definisci un elemento <Result> per ogni itinerario che vuoi aggiornare. Per gli aggiornamenti dei metadati, definisci i dati della camera e del pacchetto per ogni proprietà che è cambiata.

Per ogni messaggio Transaction ricevuto, Google risponde con un messaggio HTTP 200 OK del server per indicare che l'operazione è riuscita. Se Google risponde con un codice di errore HTTP, invia di nuovo il messaggio Transaction. In caso di problemi durante l'invio o la ricezione di messaggi, consulta la sezione Risoluzione dei problemi.

Devi inviare un messaggio Transaction per ogni itinerario (combinazione proprietà/check-in data/durata del soggiorno) in cui il prezzo è cambiato. Puoi inviare fino a 5 messaggi Transaction al secondo. Google non bloccherà i messaggi inviati più spesso di 5 al secondo, ma il messaggio potrebbe scadere in attesa che altre richieste vengano completate.

Per ridurre il traffico di rete, puoi combinare più elementi <Result> in un singolo messaggio Transaction.

In genere, Google elabora i dati aggiornati su prezzi e disponibilità in circa 5 minuti. I prezzi verranno eliminati dopo 90 giorni.

Per ulteriori informazioni sull'utilizzo dei messaggi Transaction per aggiornare i prezzi, consulta la sezione Impostare i prezzi.

Aggiornamento dei metadati di camere e pacchetti con il push

Per aggiornare i metadati di camere e pacchetti, invia gli aggiornamenti come faresti con qualsiasi altro aggiornamento. In questo caso, invii un messaggio Transaction con le nuove informazioni negli elementi <RoomData> e <PackageData>. Questi elementi sono elementi secondari dell'elemento <PropertyDataSet>.

Per ulteriori informazioni, consulta la sezione Definire i metadati di camere e pacchetti.

Errori della modalità di invio

Se ricevi un errore HTTP quando invii un messaggio Transaction a Google, prova a eseguire di nuovo la richiesta a intervalli di 1, 5 e 20 minuti. Se il problema persiste dopo 3 tentativi, interrompi l'invio di messaggi e contatta il tuo account manager Google.

Quando contatti l'account manager Google per segnalare l'errore HTTP che hai ricevuto durante l'invio di un messaggio Transaction, Google esegue dei test per circa 10 hotel mentre collabori con te per verificare che i feed siano configurati correttamente. Se i test hanno esito positivo, Google esegue la scansione dell'intero insieme di hotel specificato nel tuo feed prezzi degli hotel. Ciò garantisce che i carichi siano accettabili e che i prezzi rimangano accurati per 3-5 giorni. Dopodiché, Google ti avviserà del lancio e potrai fare riferimento ai tuoi risultati in tempo reale.

Con quale frequenza devono essere inviati i prezzi?

Possibilmente, esegui il push di tutti gli aggiornamenti non appena ti rendi conto che un prezzo è cambiato. Se non sai quando sono stati modificati i prezzi, devi provare a mantenere i prezzi aggiornati il più spesso possibile. In genere, questo comporta più push al giorno. In genere, gli itinerari relativi al giorno e alla settimana correnti vengono inviati molto più spesso.