Hai bisogno di un server di prenotazione per consentire al Centro azioni di effettuare callback per creare e aggiornare le prenotazioni per tuo conto. In questo modo, Actions Center può creare appuntamenti, prenotazioni e riservazioni con te per conto dell'utente.
Per scoprire come configurare la connessione ai server di prenotazione Sandbox e di produzione, consulta Configurare le credenziali del server di prenotazione.
Completa le seguenti attività di preparazione del server di prenotazione prima di passare agli aggiornamenti in tempo reale:
- BatchAvailabilityLookup page load Ready
- BatchAvailabilityLookup slot click Ready
- CreateBooking Ready
- UpdateBooking Ready
- Attiva il controllo della disponibilità nelle funzionalità dell'account della configurazione di Actions Center.
Ogni attività viene contrassegnata come completata e diventa verde quando invii dettagli dell'inventario accurati e in tempo reale alle richieste del server di prenotazione tramite il flusso di prenotazione sandbox. Le tappe fondamentali del server di prenotazione vengono analizzate in un periodo di 14 giorni.
Implementare un'interfaccia API REST
Implementa un'interfaccia API basata su REST. In questo modo, Google può inviare richieste al server di prenotazione tramite HTTPS.
Per implementare un'interfaccia API, configura un server di prenotazione di sviluppo o sandbox che si connette all'ambiente sandbox di Actions Center. Passa a un ambiente di produzione solo dopo aver testato completamente il server sandbox.
Tutte le richieste del server di prenotazione di Google sono relative all'URL del server di prenotazione impostato nella pagina Server di prenotazione. Ad esempio, se il tuo URL è impostato su api.example.com/google, tutte le
richieste HealthCheck vengono inviate a api.example.com/google/v3/HealthCheck.
Assicurati che l'endpoint del server di prenotazione corretto sia configurato per gli ambienti sandbox e di produzione con il selettore di ambiente.
Sicurezza e autenticazione
Tutte le comunicazioni con il tuo server di prenotazione avvengono tramite HTTPS utilizzando l'autenticazione di base. Per configurare il server, ti consigliamo di utilizzare uno strumento di verifica SSL o TLS disponibile pubblicamente, ad esempio SSL Server Test di Qualys.
Tutte le richieste che Google invia al tuo server di prenotazione vengono autenticate con l'autenticazione di base HTTPS. Puoi inserire le informazioni di autenticazione di base, la password e il nome utente del tuo server di prenotazione nella pagina di configurazione del server di prenotazione di Actions Center. Le credenziali devono essere modificate ogni sei mesi.
Crea il server di prenotazione
Il server di prenotazione determina il modo in cui l'integrazione comunica con il tuo sistema e crea o aggiorna le prenotazioni. Per configurare la connessione ai server di prenotazione sandbox e di produzione, vedi Configurare le credenziali del server di prenotazione.
Ogni risposta che il tuo server di prenotazione fornisce a una richiesta di Prenota con Google deve contenere dettagli dell'inventario accurati e in tempo reale. La tabella seguente mostra i metodi per ogni implementazione e include i link ai formati dei protocolli di servizio:
| Metodo | Definizione | Risposta | Richiesta HTTP |
|---|---|---|---|
Caricamento pagina BatchAvailabilityLookup |
Quando un utente fa clic su Prenota un tavolo per il tuo commerciante, la
richiesta Il payload contiene numerosi slot basati sugli ultimi caricamenti del feed, che Prenota con Google considera disponibili. |
La risposta deve includere ogni richiesta di slot e la disponibilità attuale dello slot. In questo modo, si impedisce la visualizzazione di eventuali slot non disponibili. | POST /v3/BatchAvailabilityLookup/ |
BatchAvailabilityLookup clic sullo spazio |
Quando a un utente vengono mostrati gli slot disponibili per la prenotazione e fa clic su uno slot, viene chiamata la richiesta BatchAvailabilityLookup per il clic sullo slot. |
La risposta deve rappresentare la disponibilità attuale e reale dello slot. Se è esaurito prima del clic sullo slot, restituisci la risposta che non è disponibile. | POST /v3/BatchAvailabilityLookup/ |
CreateBooking |
Quando un utente conferma di voler prenotare una fascia oraria selezionata nel
modulo di prenotazione, viene inviata la richiesta CreateBooking. |
La risposta deve rappresentare l'esito positivo o negativo della prenotazione. Se la prenotazione non è andata a buon fine, devi restituire il
motivo specifico del mancato esito positivo. Ad esempio, lo slot è stato prenotato prima che
venisse chiamata la risposta Se viene creata una prenotazione riuscita, la risposta include un |
POST /v3/CreateBooking/ |
UpdateBooking |
Dopo aver effettuato una prenotazione tramite Prenota con Google, l'utente può scegliere
di modificarla. Quando l'utente aggiorna la prenotazione o la annulla, viene inviata una richiesta UpdateBooking. |
Come la risposta CreateBooking, la tua risposta a
UpdateBooking deve rappresentare l'esito positivo della prenotazione o
restituire il motivo specifico di un errore. |
POST /v3/UpdateBooking/ |
HealthCheck |
Il Centro azioni effettua chiamate regolari al tuo server di prenotazione per confermare che la tua infrastruttura sia attiva e in esecuzione. | Utilizza il codice di stato HTTP per indicare lo stato di pubblicazione del tuo server. Restituisci un codice di stato HTTP 200 se il server è attivo e in esecuzione correttamente. Per indicare un errore o per disattivare temporaneamente l'integrazione, restituisci il codice di stato HTTP non 2xx appropriato. |
GET /v3/HealthCheck/ |
Flusso di prenotazione della sandbox
Per visualizzare il flusso di prenotazione della sandbox, vai alla visualizzazione Inventario del Centro azioni. La colonna RwG - E2E della visualizzazione Inventario mostra un link Live (in Sandbox) al flusso di prenotazione Sandbox per i commercianti Sandbox che sono corrispondenti e hanno disponibilità futura.
Di seguito sono riportate le azioni nel flusso di prenotazione:
- Quando fai clic sul link RwG - E2E, viene attivata una richiesta
BatchAvailabilityLookupal caricamento della pagina e viene visualizzata la disponibilità nota del commerciante. - Quando fai clic su un orario di prenotazione, viene attivata la richiesta
BatchAvailabilityLookupal clic sullo slot e viene visualizzata la finestra modale di prenotazione. - Completa una prenotazione con la modale di prenotazione per inviare la richiesta di
CreateBooking. - Dopo aver completato una prenotazione nell'ambiente sandbox, l'account utilizzato per creare la prenotazione riceve un'email di conferma con i dettagli della prenotazione.
- Per attivare il metodo
UpdateBooking, modifica o annulla la prenotazione dall'email.
HealthCheck
Assicurati di implementare il metodo HealthCheck in Sandbox e Produzione. Questo
metodo restituisce lo stato di integrità del server di prenotazione. Consente a Google di monitorare costantemente
lo stato di pubblicazione del tuo server di prenotazione.
Richiesta: nessuna
Valore restituito: nessuno
Utilizza il codice di stato HTTP per indicare lo stato di pubblicazione del tuo server.
Se il server è attivo e funziona correttamente, restituisci un codice di stato HTTP 200 oppure, per indicare un errore, restituisci uno dei codici di stato HTTP.