Casi d'uso per gli aggiornamenti in tempo reale
Gli aggiornamenti in tempo reale devono sempre essere emessi nei seguenti scenari:
- Quando un utente annulla una prenotazione nel tuo sistema e lo spazio diventa disponibile.
- Quando un utente prenota un'attività tramite il Centro azioni e lo spazio di disponibilità non è più disponibile.
- Quando una prenotazione effettuata tramite il Centro azioni viene annullata da te, ad esempio direttamente dal commerciante. Dovrai aggiornare la prenotazione e la disponibilità perché lo slot originale è di nuovo disponibile.
Inoltre, se implementi Disponibilità sostituisce RTU, gli aggiornamenti in tempo reale devono essere emessi nei seguenti scenari:
- Quando un commerciante modifica il suo programma (disponibilità) nel tuo sistema.
- Quando un utente prenota un servizio sul tuo sistema e lo spazio di disponibilità non è più disponibile.
-
Se utilizzi un'integrazione precedente con
CheckAvailability, quando una chiamata al server di prenotazioneCheckAvailabilityrestituisce un inventario che non corrisponde a quello effettivo.
Non tutte le chiamate all'API Maps Booking sono obbligatorie. I seguenti requisiti 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 prenotazione
Se è stato apportato un aggiornamento a una prenotazione del Centro azioni (ad es. annullata o modificata) nel tuo sistema, deve essere inviato un messaggio notification.partners.bookings.patch (BookingNotification.UpdateBooking).
Campi modificabili
statusstartTimedurationpartySizepaymentInformation.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": "2025-01-02T15:01:23.045123456Z", "duration": "3000s", "status": "CANCELED" }
Disponibilità sostituisci RTU
Esistono due tipi di metodi di sostituzione disponibili per aggiornare la disponibilità:
-
Sostituisci batch (
InventoryUpdate.BatchServiceAvailability): sostituisce completamente i dati sulla disponibilità di più commercianti e servizi.- Nota: questa chiamata batch non garantisce l'atomicità. Verranno restituiti solo gli intervalli di disponibilità aggiornati correttamente.
-
Sostituisci singola (
InventoryUpdate.ReplaceServiceAvailability): sostituisce completamente la disponibilità per un singolo commerciante e servizio.
Per ulteriori dettagli, consulta la seguente documentazione.
Gli aggiornamenti in tempo reale devono utilizzare la stessa struttura di disponibilità dei dati inviati tramite i feed. Deve utilizzare uno dei seguenti:
spotsOpenrecurrence
Scegliere un metodo di sostituzione da chiamare
Utilizza la seguente guida per determinare quale metodo di sostituzione è più adatto:
- Sono interessati più commercianti? Ad esempio, sostituisci la disponibilità per più commercianti in una richiesta.
- Il sistema si sincronizzerà di volta in volta con quello di Google inviando tutte le modifiche alla disponibilità dall'ultimo aggiornamento (non consigliato).
- Sostituisci in blocco
- Nota: prevediamo che l'RTU dell'inventario venga inviato entro 5 minuti dall'aggiornamento da parte tua. Pertanto, devi controllare e inviare eventuali aggiornamenti almeno ogni 5 minuti.
- Nessuna di queste condizioni si applica o devi aggiornare solo un commerciante e un servizio?
- Sostituisci singola
- Nota: puoi utilizzare più chiamate di sostituzione singola per emulare una chiamata di sostituzione collettiva, ma sarebbe più efficiente utilizzare una singola chiamata di sostituzione collettiva
Aggiornamenti in tempo reale: formato aperto degli spot
È importante utilizzare lo stesso formato per i feed, il server di prenotazione e gli aggiornamenti in tempo reale.
Uno snippet del feed spots_open ha il seguente aspetto:
Snippet del feed
"availability": [
{
"merchant_id": "1001",
"service_id": "12310",
"spots_open": 2,
"spots_total": 2,
"start_sec": 1735831800, # January 02, 2025 15:30:00
"duration_sec": 1800,
"availabilityTag": "1000001"
}
]Per l'API Inventory Update, il formato del corpo della richiesta di sostituzione quando viene prenotato uno slot alle 15:30:
Sostituisci lo snippet Aggiornamenti in tempo reale
{
"extendedServiceAvailability": [
{
"merchantId": "1001",
"serviceId": "12310",
"startTimeRestrict": "2025-01-02T15:01:23.045123456Z",
"endTimeRestrict": "2025-01-02T19:01:23.045123456Z",
"availability": [
{
"startTime": "2025-01-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 viene prenotato un nuovo spazio alle 15:30:
Snippet del feed
"availability": [
{
"merchant_id": "1001",
"service_id": "12310",
"spots_open": 1,
"spots_total": 2,
"start_sec": 1735831800, # January 02, 2025 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 gli aggiornamenti in tempo reale.
Un feed che utilizza la ricorrenza ha il seguente aspetto:
Snippet del 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 quando viene prenotato uno slot alle 15:30 è simile al seguente:
{
"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 è previsto nel prossimo feed giornaliero. Tieni presente che si tratta della disponibilità dell'intero servizio per il commerciante e di tutti i suoi schedule_exceptionsprecedenti e nuovi:
Snippet del 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 gli aggiornamenti in tempo reale
Gli aggiornamenti in tempo reale devono essere inviati continuamente ogni volta che la disponibilità cambia. Oltre a questo, è necessario inviare un feed di disponibilità completo una volta al giorno per garantire la sincronizzazione della disponibilità tra i tuoi sistemi e quelli di Google.