Strutturare gli aggiornamenti in tempo reale

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 sul 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 del server di prenotazione CheckAvailability restituisce un inventario che non corrisponde a quello effettivo.

Non tutte le chiamate all'API Maps Booking sono obbligatorie. I seguenti requisiti sono obbligatori:

A seconda del tipo di integrazione, potrebbero essere disponibili o richiesti anche i seguenti elementi:

Aggiorna RTU prenotazione

Se nel tuo sistema è stato apportato un aggiornamento a una prenotazione del Centro azioni (ad es. annullata o modificata), deve essere inviata un'notification.partners.bookings.patch (BookingNotification.UpdateBooking).

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à sostituisci RTU

Esistono due tipi di metodi di sostituzione disponibili per aggiornare la disponibilità:

  • Sostituisci in blocco (InventoryUpdate.BatchServiceAvailability): Sostituisci completamente i dati sulla disponibilità di un commerciante e di più servizi.
    • Nota: questa chiamata batch non garantisce l'atomicità. Verranno restituiti solo gli slot 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:

  • spotsOpen
  • recurrence

Scegliere un metodo di sostituzione da chiamare

Utilizza la seguente guida per determinare quale metodo di sostituzione è più adatto:

  • Sono interessati più servizi con una singola prenotazione? Ad esempio, un taglio e una colorazione (ciascuno è un servizio distinto) vengono prenotati con un parrucchiere, pertanto tutti i servizi collegati al parrucchiere per quella fascia oraria devono essere rimossi.
  • 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 opzioni si applica al tuo caso?
    • 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": 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 quando viene prenotato un intervallo alle 15:30:

Sostituisci lo snippet 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 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": 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 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.