Per consentire ad Actions Center di effettuare callback per creare e aggiornare le prenotazioni per tuo conto, devi avere un server di prenotazione. 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 di produzione e sandbox, consulta Configurare le credenziali del server di prenotazione.
Completa le seguenti attività relative al server di prenotazione prima di passare agli aggiornamenti in tempo reale:
- Caricamento pagina BatchAvailabilityLookup Pronto
- Clic sullo slot BatchAvailabilityLookup Pronto
- CreateBooking Pronto
- UpdateBooking Pronto
- Attiva il controllo della disponibilità nelle funzionalità dell'account di configurazione di Actions Center Account features
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 della sandbox. I traguardi del server di prenotazione vengono analizzati 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 del server di prenotazione tramite HTTPS.
Per implementare un'interfaccia API, configura un server di prenotazione di sviluppo o sandbox che si connetta 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
del server di prenotazione. Ad esempio, se l'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 sia per gli ambienti sandbox che di produzione con il selettore di ambiente.
Sicurezza e autenticazione
Tutte le comunicazioni con il server di prenotazione avvengono tramite HTTPS utilizzando l'autenticazione di base. Per facilitare la configurazione del server, ti consigliamo di utilizzare uno strumento di verifica SSL o TLS disponibile pubblicamente, ad esempio il test del server SSL 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 server di prenotazione nella pagina di configurazione del server di prenotazione di Actions Center. Le credenziali devono essere modificate ogni sei mesi.
Creare il server di prenotazione
Il server di prenotazione determina il modo in cui l'integrazione comunica con il tuo sistema ed effettua o aggiorna le prenotazioni. Per configurare la connessione ai server di prenotazione di produzione e sandbox, consulta Configurare le credenziali del server di prenotazione.
Ogni risposta che il 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 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
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 evita la visualizzazione di slot non disponibili. | POST /v3/BatchAvailabilityLookup/ |
Clic sullo slot BatchAvailabilityLookup |
Quando a un utente vengono presentati gli slot disponibili per la prenotazione e fa clic su un
slot, la BatchAvailabilityLookup richiesta viene chiamata per il clic sullo slot. |
La risposta deve rappresentare la disponibilità attuale e reale dello slot. Se lo slot è esaurito prima del clic, restituisci la risposta che non è disponibile. | POST /v3/BatchAvailabilityLookup/ |
CreateBooking |
Quando un utente conferma di voler prenotare uno slot orario selezionato nel
modale di prenotazione, viene inviata la richiesta CreateBooking. |
La risposta deve rappresentare l'esito positivo o negativo della prenotazione. Se la prenotazione non va a buon fine, devi restituire il
motivo specifico del problema. Ad esempio, lo slot è stato prenotato prima che venisse chiamata la
Se viene creata una prenotazione riuscita, la risposta include un
|
POST /v3/CreateBooking/ |
UpdateBooking |
Dopo aver effettuato una prenotazione tramite Prenota con Google, un utente può scegliere
di modificarla. Quando l'utente aggiorna o annulla
la prenotazione, viene inviata una richiesta UpdateBooking. |
Come la risposta CreateBooking, la risposta a
UpdateBooking deve rappresentare l'esito positivo della prenotazione o
restituire il motivo specifico di un errore. |
POST /v3/UpdateBooking/ |
HealthCheck |
Actions Center effettua chiamate regolari al server di prenotazione per verificare che l'infrastruttura sia attiva e in esecuzione. | Utilizza il codice di stato HTTP per indicare lo stato di pubblicazione del server. Restituisci un codice di stato HTTP 200 se il server è attivo e in esecuzione correttamente. Per indicare un errore o disattivare temporaneamente l'integrazione, restituisci il codice di stato HTTP non 2xx appropriato. |
GET /v3/HealthCheck/ |
Criteri per i traguardi
Per completare il traguardo Server di prenotazione pronto, l'integrazione deve soddisfare i seguenti criteri negli ambienti sandbox e di produzione:
| Metodo | Numero di richieste obbligatorio (sandbox) | Numero di richieste obbligatorio (produzione) | Percentuale di successo richiesta |
|---|---|---|---|
Caricamento pagina BatchAvailabilityLookup |
20 | 20 | 90% |
Clic sullo slot BatchAvailabilityLookup |
20 | 20 | 90% |
CreateBooking |
10 | 3 | 90% |
UpdateBooking |
10 | 3 | 90% |
Flusso di prenotazione della sandbox
Per visualizzare il flusso di prenotazione della sandbox, vai alla visualizzazione dell'inventario di Actions Center Inventory. La colonna RwG - E2E della visualizzazione dell'inventario mostra un link Live (in sandbox) al flusso di prenotazione della sandbox per i commercianti della 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 visualizzato il modale di prenotazione.Completa una prenotazione con il modale di prenotazione per inviare la richiesta
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 nella sandbox e nella produzione. Questo metodo restituisce lo stato di integrità del server di prenotazione. Consente a Google di monitorare continuamente lo stato di pubblicazione del server di prenotazione.
Richiesta: nessuna
Valore restituito: nessuno
Utilizza il codice di stato HTTP per indicare lo stato di pubblicazione del server.
Se il server è attivo e in esecuzione, restituisci un codice di stato HTTP 200, oppure, per indicare un errore, restituisci uno dei codici di stato HTTP.