Casi d'uso per gli aggiornamenti in tempo reale
Gli aggiornamenti in tempo reale devono essere sempre eseguiti nei seguenti scenari:
- Quando un utente annulla una prenotazione sul tuo sistema e lo slot diventa disponibili.
- Quando un utente prenota una prenotazione tramite il Centro azioni e lo slot di disponibilità non è più disponibile.
- Quando una prenotazione effettuata tramite il Centro azioni viene annullata sul tuo ad esempio direttamente dal commerciante. Dovrai aggiornare così come la disponibilità, poiché lo spazio originale è ora disponibile di nuovo.
Inoltre, se implementi Disponibilità - Sostituisci RTU, Gli aggiornamenti in tempo reale devono essere eseguiti nei seguenti scenari:
- Quando un commerciante modifica la propria programmazione (disponibilità) sul tuo sistema.
- Quando un utente prenota una prenotazione sul tuo sistema e lo slot di disponibilità non è più disponibile.
-
Se utilizzi un'integrazione precedente con
CheckAvailability
, Quando un server di prenotazioneCheckAvailability
: la chiamata restituisce un inventario che non corrisponde a quello effettivo.
Non tutte le chiamate all'API Maps Booking sono obbligatorie. I seguenti campi sono obbligatori:
-
notification.partners.bookings.patch
(BookingNotification.UpdateBooking
)
A seconda del tipo di integrazione, potrebbero essere disponibili o richiesti anche i seguenti elementi:
inventory.partners.availability.replace
(InventoryUpdate.BatchServiceAvailability
) OPPUREinventory.partners.merchants.services.availability.replace
(InventoryUpdate.ReplaceServiceAvailability
)
Aggiorna RTU di prenotazione
Nel caso in cui sia stato aggiornato una prenotazione del Centro azioni (ad es. annullata o
modificata) sul tuo sistema,
notification.partners.bookings.patch
(BookingNotification.UpdateBooking
)
devono essere inviati.
Campi modificabili
status
startTime
duration
partySize
paymentInformation.prepaymentStatus
Esempio di annullamento
Request: PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/<PARTNER_ID>/bookings/<BOOKING_ID>?updateMask=status Body: { "name": "partners/<PARTNER_ID>/bookings/<BOOKING_ID>", "merchantId": "10001", "serviceId": "1001", "startTime": "2014-10-02T15:01:23.045123456Z", "duration": "3000s", "status": "CANCELED" }
Disponibilità sostituzione RTU
Sono disponibili due tipi di metodi di sostituzione per aggiornare disponibilità:
-
Sostituzione in gruppo (
InventoryUpdate.BatchServiceAvailability
): Sostituisce completamente i dati sulla disponibilità di un commerciante e di più i servizi di machine learning.- Nota: questa chiamata batch non garantisce l'atomicità. Solo verranno restituiti gli slot di disponibilità aggiornati correttamente.
-
Sostituzione singola (
InventoryUpdate.ReplaceServiceAvailability
): Sostituisce completamente la disponibilità di un singolo commerciante e servizio.
Utilizza quanto segue riferimento per ulteriori informazioni i dettagli.
Gli aggiornamenti in tempo reale devono utilizzare la stessa struttura di disponibilità dei dati inviate tramite i feed. Deve utilizzare uno dei seguenti elementi:
spotsOpen
recurrence
Scelta di un metodo di sostituzione da chiamare
Utilizza la seguente guida per determinare il metodo di sostituzione più efficace adatte:
- Una singola prenotazione ha impatto su più servizi? Ad esempio, un taglio di capelli e colorare (ciascuno è un servizio distinto) è prenotato da un parrucchiere, in modo che i servizi associati allo stilista per quella fascia oraria devono essere rimossi.
- Il sistema si sincronizzerà con i server di Google di tanto in tanto inviando tutti
variazioni della disponibilità dall'ultimo aggiornamento (sconsigliato).
- Sostituzione in gruppo
- Nota: prevediamo che la RTU dell'inventario venga inviata entro 5 minuti dal verificarsi di un aggiornamento dal tuo lato. Dovresti quindi controllare e inviare eventuali aggiornamenti almeno ogni 5 minuti.
- Nessuno di questi è applicabile?
- Sostituzione singola
- Nota: puoi utilizzare più chiamate di sostituzione singola per emulare un di sostituzione in batch, ma sarebbe più efficiente usare un singolo chiamata di sostituzione in gruppo
Aggiornamenti in tempo reale: formato Spot aperto
È importante utilizzare lo stesso formato per i feed, il server di prenotazione e aggiornamenti in tempo reale.
Uno snippet del feed spots_open
ha il seguente aspetto:
Snippet feed
"availability": [ { "merchant_id": "1001", "service_id": "12310", "spots_open": 2, "spots_total": 2, "start_sec": 1412263800, # October 02, 2014 15:30:00 "duration_sec": 1800, "availabilityTag": "1000001" } ]
Per l'API Inventory Update, il formato del corpo della richiesta di sostituzione per quando La fascia oraria delle 15:30 viene prenotata:
Sostituisci snippet di aggiornamenti in tempo reale
{ "extendedServiceAvailability": [ { "merchantId": "1001", "serviceId": "12310", "startTimeRestrict": "2014-10-02T15:01:23.045123456Z", "endTimeRestrict": "2014-10-02T19:01:23.045123456Z", "availability": [ { "startTime": "2014-10-02T15:30:00.00Z", "duration": "3600s", "spotsOpen": "1", "spotsTotal": "2", "availabilityTag": "1000001" } ] } ] }
Ecco un esempio di ciò che ci aspettiamo nel prossimo feed giornaliero, se una nuova area 15:30 si prenota:
Snippet feed
"availability": [ { "merchant_id": "1001", "service_id": "12310", "spots_open": 1, "spots_total": 2, "start_sec": 1412263800, # October 02, 2014 15:30:00 "duration_sec": 1800, "availabilityTag": "1000001" } ]
Aggiornamenti in tempo reale: formato della ricorrenza
È importante utilizzare lo stesso formato per i feed, il server di prenotazione e aggiornamenti in tempo reale.
Un feed che utilizza la ricorrenza ha il seguente aspetto:
Snippet feed
"availability": [ { "merchant_id": "1001", "service_id": "12310", "spots_open": 1, "spots_total": 1, "start_sec": 1540890000, # October 30, 2018 9:00:00 AM "duration_sec": 1800, "recurrence": { "repeat_every_sec": 1800, "repeat_until_sec": 1540918800 # October 30, 2018 5:00:00 PM }, "schedule_exception": [ { "time_range": { "begin_sec": 1540902600, # October 30, 2018 12:30:00 PM "end_sec": 1540904400 # October 30, 2018 1:00:00 PM } } ], } ]
Per l'API Inventory Update, il formato del corpo della richiesta di sostituzione per quando La fascia oraria delle 15:30 viene prenotata, ad esempio:
{ "extendedServiceAvailability": [ { "merchantId": "1001", "serviceId": "12310", "startTimeRestrict": "2018-10-30T15:01:23.045123456Z", "endTimeRestrict": "2018-10-30T19:01:23.045123456Z", "availability": [ { "startTime": "2018-10-30T15:30:00.00Z", "duration": "3600s", "spotsOpen": "1", "scheduleException": [ { "timeRange": { "startTime": "2018-10-30T12:30:00.00Z", "endTime": "2018-10-30T13:00:00.00Z" } }, { "timeRange": { "startTime": "2018-10-30T15:30:00.00Z", "endTime": "2018-10-30T16:00:00.00Z" } } ] } ] } ] }
Ecco un esempio di ciò che ci si aspetta nel prossimo feed giornaliero. Nota che
è la disponibilità dell'intero servizio per quel commerciante e tutte le sue
schedule_exceptions
precedente e nuovo:
Snippet feed
"availability": [ { "merchant_id": "1001", "service_id": "12310", "spots_open": 1, "spots_total": 1, "start_sec": 1540890000, # October 30, 2018 9:00:00 AM "duration_sec": 1800, "recurrence": { "repeat_every_sec": 1800, "repeat_until_sec": 1540918800 # October 30, 2018 5:00:00 PM }, "schedule_exception": [ { "time_range": { "begin_sec": 1540902600, # October 30, 2018 12:30:00 PM "end_sec": 1540904400 # October 30, 2018 1:00:00 PM } }, { "time_range": { "begin_sec": 1540913400, # October 30, 2018 3:30:00 PM "end_sec": 1540915200 # October 30, 2018 4:00:00 PM } } ], } ]
Quando inviare aggiornamenti in tempo reale
Gli aggiornamenti in tempo reale devono essere inviati continuamente ogni volta che la disponibilità cambia. Tutto ciò si aggiunge a un feed di disponibilità esauriente, che dovrebbe inviate una volta al giorno, per garantire la sincronizzazione della disponibilità tra i tuoi sistemi e quelli di Google.