L'inventario nel tuo sistema cambia a causa di nuove prenotazioni, annullamenti e modifiche alla pianificazione da parte dei tuoi commercianti. L'API Real-Time Update (RTU) è un meccanismo per notificare a Google queste modifiche e quelle apportate alle prenotazioni esistenti.
Le RTU sono necessarie nei seguenti casi:
- Quando un utente annulla una prenotazione nel tuo sistema e lo slot diventa disponibile.
- Quando un utente prenota una prenotazione tramite Actions Center e lo slot non è più disponibile.
- Quando una prenotazione effettuata tramite Actions Center viene annullata da parte tua. Un esempio è l'annullamento diretto da parte del commerciante. Devi aggiornare la prenotazione e la disponibilità, perché lo slot originale è ora disponibile.
Completa la seguente attività fondamentale RTU prima di passare alla revisione della sandbox:
Ogni attività viene contrassegnata come completata e diventa verde quando le ultime 20 richieste non presentano errori per un periodo di 14 giorni. Continua a inviare richieste riuscite per assicurarti che la milestone rimanga verde.
API RTU e feed
Le RTU API notificano a Google le modifiche incrementali alla disponibilità dell'inventario e alle prenotazioni in tempo reale. Oltre alle unità di trattamento dell'aria, invia ogni giorno feed di disponibilità completi. In questo modo, Google dispone delle informazioni sulla disponibilità più accurate e aggiornate presenti nel tuo sistema. I feed completi fungono da istantanea dello stato più recente della disponibilità dell'inventario nel tuo sistema.
Per maggiori informazioni, consulta le seguenti risorse:
Accedi all'API
Il tuo progetto Google Cloud è il modo in cui accedi all'API Maps Booking del Centro azioni, che è il modo in cui invii gli aggiornamenti in tempo reale. Devi utilizzare un Account Google all'interno della console Google Developers e fornire il numero del tuo progetto Cloud nella milestone di configurazione del tuo piano di onboarding. Per maggiori informazioni su come abilitare le API Cloud, consulta la sezione Abilitare le API Cloud.
Utilizza chiamate RESTful o scarica la libreria client
Ti consigliamo di effettuare chiamate RESTful direttamente all'API Maps Booking con payload JSON. Per saperne di più, consulta la documentazione dell'API REST.
Puoi anche utilizzare le librerie client per connetterti all'API.
.| Lingua | Link di download |
|---|---|
| Java | Libreria client Java. Per saperne di più, consulta le istruzioni per il client Java. |
Sono disponibili per il download librerie di supporto aggiuntive che gestiscono l'autorizzazione e altri aspetti delle chiamate alle API di Google. Per ulteriori informazioni, vedi Esempi di codice.
Recuperare il documento di rilevamento
Per alcune librerie client, come Ruby, è necessario recuperare il documento Discovery per l'API che descrive i relativi metodi e parametri.
Per recuperare il documento di rilevamento, utilizza il comando seguente:
curl -s -o mapsbooking_rest
https://mapsbooking.googleapis.com/$discovery/rest?version=v1alpha
Per ulteriori informazioni su come accedere all'API da Ruby, consulta Client API Ruby e Libreria di autenticazione Ruby.
Esegui chiamate autorizzate all'API
Quando effettui chiamate all'API, consulta Prepararsi a effettuare una chiamata API delegata per autorizzare il tuo service account con la tua chiave privata e il seguente ambito OAuth:
https://www.googleapis.com/auth/mapsbooking
Endpoint sandbox e di produzione
Puoi effettuare chiamate sia all'ambiente sandbox sia a quello di produzione tramite l'API. Assicurati di abilitare entrambe le API nel tuo progetto Google Cloud. Entrambe le API utilizzano lo stesso ambito, ma hanno endpoint diversi.
Endpoint di produzione: https://mapsbooking.googleapis.com/
Endpoint sandbox: https://partnerdev-mapsbooking.googleapis.com/
Di seguito è riportato un esempio in Java di come cambiare endpoint:
// This block of code is for OAuth and is the same for prod and sandbox.
GoogleCredential
.fromStream(new FileInputStream(...))
.createScoped(Collections.singleton("https://www.googleapis.com/auth/mapsbooking"))
// This block of code sets the endpoint. This is what you'd change to connect to the sandbox.
new GoogleMapsBookingAPI.Builder(...)
.setApplicationName(...)
.setRootUrl("https://partnerdev-mapsbooking.googleapis.com/") // you add this to change the endpoint to use partnerdev.
.build()