Questa sezione fornisce maggiori dettagli sulle tre parti principali di un'integrazione con il Centro azioni. Utilizzerai ciascuna di queste opzioni 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 tuoi dati contemporaneamente per aggiornare i commercianti, i servizi e le aree di disponibilità utilizzando un caricamento SFTP.
API Maps Booking
L'API Maps Booking ti consente di aggiornare gli oggetti nel sistema del Centro azioni tra un invio di feed e l'altro per mantenere aggiornate le informazioni. L'API consente anche di annullare le prenotazioni effettuate tramite l'integrazione end-to-end di Prenota con Google.
Gli aggiornamenti in tempo reale vengono implementati tramite le chiamate REST.
Server di prenotazione
Affinché l'integrazione end-to-end del Centro azioni possa creare prenotazioni per tuo conto, devi configurare un server di prenotazione.
API REST
La versione 3 è la versione più recente 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 al Centro azioni. I contenuti dei feed definiscono quali servizi offri e quando.
Controlla l'accordion References and Samples 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 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 se è vuoto.
Il formato dei feed viene 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 del Centro Azioni. Per informazioni generali su come utilizzare i buffer di protocollo per generare un file pb3, ecco un esempio in Java.