W tej sekcji znajdziesz więcej informacji o 3 głównych elementach integracji z Centrum działań. Użyjesz ich w konkretnych krokach opisanych w pełnym przewodniku.
Pliki danych
Pliki danych to pliki w formacie JSON lub pb3, które służą do przesyłania danych o asortymencie do Centrum działań. Dzięki temu możesz przesłać wszystkie dane naraz, aby zaktualizować informacje o sprzedawcach, usługach i slotach dostępności, korzystając z przesyłania SFTP.
Interfejs API rezerwacji w Mapach Google
Interfejs Maps Booking API umożliwia aktualizowanie obiektów w systemie Actions Center pomiędzy przesyłaniem plików danych, aby informacje były aktualne. Interfejs API umożliwia też anulowanie rezerwacji dokonanych za pomocą funkcji Zarezerwuj z Google w ramach pełnej integracji.
Aktualizacje w czasie rzeczywistym są implementowane za pomocą wywołań REST.
Serwer rezerwacji
Aby pełna integracja z Actions Center mogła tworzyć rezerwacje w Twoim imieniu, musisz skonfigurować serwer rezerwacji.
Interfejs API typu REST
Wersja 3 to najnowsza wersja interfejsu API, która obsługuje interfejs oparty na protokole REST. Wszystkie nowe integracje powinny używać interfejsu API w wersji 3.
Ta sekcja określa pliki danych służące do przesyłania danych asortymentu do Centrum akcji. Treść plików danych określa, jakie usługi oferujesz, jakie są dostępne usługi i kiedy są one dostępne.
Aby dowiedzieć się, jak udostępnić nam te pliki danych, otwórz sekcję Przykłady i materiały odniesienia.
Strukturę plików danych o asortymencie definiuje interfejs Google Maps Booking API.
W przypadku każdej integracji wymagany jest ten plik danych:
- Plik danych o sprzedawcach: zawiera dane opisujące Twoich sprzedawców.
Ponadto do pełnej integracji wymagane są 2 podane niżej pliki danych.
- Kanał danych usług: zawiera informacje o usługach oferowanych przez Twoich sprzedawców.
- Plik danych o dostępności: zawiera listę dostępnych slotów czasowych usług świadczonych przez Twoich sprzedawców.
Niektóre pola w tych plikach danych są wymagane, a inne opcjonalne. W pliku danych można pominąć puste pola oznaczone jako opcjonalne.
Format plików danych jest opisany za pomocą składni protokołu 3. Możesz przesłać plik danych jako binarną serializację danych bufora protokołu w formacie pb3 lub w pochodnym formacie JSON. Zalecamy przesyłanie plików danych w formacie JSON.
Zalecamy użycie programu do kompresji gzip przed przesłaniem plików danych.
Ten przewodnik dotyczy buforów protokołów w Centrum działań. Ogólne informacje o generowaniu pliku pb3 za pomocą protokołów dostępu: przykład w języku Java.