W tej sekcji znajdziesz więcej informacji o 3 głównych elementach integracji z Centrum działań. Każdy z nich będzie używany w krokach opisanych w przewodniku dotyczącym kompleksowej integracji.
Pliki danych
Pliki danych
to pliki w formacie JSON lub
pb3, które służą do
przesyłania danych asortymentu do Centrum działań. Dzięki temu możesz przesłać wszystkie dane naraz, aby zaktualizować sprzedawców, usługi i terminy za pomocą przesyłania przez SFTP.
Maps Booking API
Maps Booking API umożliwia aktualizowanie obiektów w systemie Centrum działań między przesyłaniem plików danych, aby informacje były aktualne. Interfejs API umożliwia też anulowanie rezerwacji dokonanych za pomocą kompleksowej integracji Zarezerwuj z Google z Google.
Aktualizacje w czasie rzeczywistym są implementowane za pomocą wywołań REST.
Serwer rezerwacji
Aby kompleksowa integracja z Centrum działań mogła tworzyć rezerwacje w Twoim imieniu, musisz skonfigurować serwer rezerwacji.
Interfejs API typu REST
Wersja v3 to najnowsza wersja interfejsu API, która obsługuje interfejs oparty na REST. Wszystkie nowe integracje powinny korzystać z interfejsu API w wersji 3.
W tej sekcji znajdziesz informacje o plikach danych używanych do przesyłania danych asortymentu do Centrum działań. Zawartość plików danych określa jakie usługi oferujesz, które z nich są dostępne i kiedy.
Aby dowiedzieć się, jak udostępniać nam te pliki danych, otwórz sekcję Materiały referencyjne i przykłady.
Strukturę plików danych o asortymencie określa Maps Booking API.
W przypadku każdej integracji wymagany jest ten plik danych:
- Plik danych sprzedawców: zawiera dane opisujące Twoich sprzedawców.
Oprócz tego w przypadku kompleksowej integracji wymagane są te 2 pliki danych:
- Plik danych usług: opisuje usługi świadczone przez Twoich sprzedawców.
- Plik danych dostępności: zawiera listę terminów usług świadczonych przez Twoich sprzedawców.
Niektóre pola w tych plikach danych są wymagane, a inne – opcjonalne. Jeśli pole oznaczone jako opcjonalne jest puste, można je pominąć w pliku danych.
Format plików danych jest opisany za pomocą składni bufora protokołu 3. Możesz przesłać plik danych jako binarną serializację danych bufora protokołu w formacie pb3 format lub w formacie JSON. Zalecamy przesyłanie plików danych w formacie JSON.
Przed przesłaniem plików danych zalecamy ich skompresowanie za pomocą gzip.
Ten przewodnik dotyczy buforów protokołu Centrum działań. Ogólne informacje o tym, jak używać buforów protokołu do generowania pliku pb3 , znajdziesz w tym przykładzie w języku Java.