Questa sezione fornisce maggiori dettagli sui 3 elementi principali di un'integrazione con Actions Center. Li utilizzerai tutti 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 ad Actions Center. 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 Actions Center tra gli invii dei feed per mantenere aggiornate le informazioni. L'API ti consente anche di annullare le prenotazioni effettuate tramite l'intelezione end-to-end di Prenota con Google .
Gli aggiornamenti in tempo reale vengono implementati utilizzando le 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 v3 è 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 dei feed utilizzati per trasmettere i tuoi dati di inventario ad Actions Center. I contenuti dei feed definiscono i servizi che fornisci, quali servizi sono disponibili e quando i servizi sono disponibili.
Consulta la sezione 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 seguenti sono obbligatori per l'integrazione end-to-end.
- Feed dei servizi: descrive i servizi forniti dai tuoi commercianti.
- Feed della 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 omesso dal feed quando è vuoto.
Il formato dei feed è descritto utilizzando la sintassi del buffer di protocollo 3. Hai la possibilità di caricare il file dei feed come serializzazione binaria dei dati del buffer di 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 di protocollo di Actions Center. Per informazioni generali su come utilizzare i buffer di protocollo per generare un file pb3 , ecco un esempio in Java.