Questa sezione fornisce ulteriori dettagli sui tre componenti principali di un'integrazione con il Centro azioni. Li utilizzerai nei passaggi descritti nella guida end-to-end.
Feed
I feed
sono file in formato JSON o
pb3 utilizzati per
trasmettere i dati di inventario al Centro azioni. In questo modo puoi
inviare tutti i dati contemporaneamente per aggiornare i commercianti, i servizi e
gli slot di disponibilità utilizzando un caricamento SFTP.
API Maps Booking
L'API Maps Booking ti consente di aggiornare gli oggetti nel sistema di Actions Center tra un invio di feed e l'altro per mantenere aggiornate le informazioni. L'API consente inoltre di annullare le prenotazioni effettuate tramite l'integrazione end-to-end di Prenota con Google.
Gli aggiornamenti in tempo reale vengono implementati utilizzando chiamate REST.
Server di prenotazione
Affinché l'integrazione end-to-end di Actions Center possa creare prenotazioni per tuo conto, devi configurare un server di prenotazione.
API REST
La versione 3 è l'ultima versione dell'API e supporta un'interfaccia basata su REST. Tutte le nuove integrazioni devono utilizzare l'API v3.
Questa sezione specifica i file del feed utilizzati per trasmettere i dati di inventario ad Actions Center. I contenuti dei tuoi feed definiscono i servizi che offri, quali sono disponibili e quando.
Esamina la sezione a scomparsa Riferimenti ed esempi per scoprire come condividere questi feed con noi.
La struttura dei feed di inventario è definita dall'API Google Maps Booking.
Il seguente feed è obbligatorio per qualsiasi integrazione:
- Feed dei commercianti: contiene i dati che descrivono i tuoi commercianti.
Inoltre, i due feed che seguono sono obbligatori per l'integrazione end-to-end.
- Feed di servizi: descrive i servizi forniti dai tuoi commercianti.
- Feed disponibilità: elenca gli slot di disponibilità dei servizi forniti dai tuoi commercianti.
Alcuni campi di questi feed sono obbligatori, mentre altri sono facoltativi. Qualsiasi campo contrassegnato come facoltativo può essere escluso dal feed se vuoto.
Il formato dei feed viene descritto utilizzando la sintassi del protocollo 3. Hai la possibilità di caricare il file dei feed come serializzazione binaria dei dati del buffer del protocollo in formato pb3 o in un formato JSON derivato. Ti consigliamo di caricare i feed in formato JSON.
Ti consigliamo di utilizzare gzip per comprimere i feed prima del caricamento.
Questa guida è specifica per i buffer del protocollo di Actions Center. Per informazioni generali su come utilizzare i protocol buffer per generare un file pb3, questo è un esempio in Java.