Ta sekcja zawiera więcej informacji o 3 głównych elementach integracji z Centrum działań. Użyjesz ich w krokach opisanych w pełnym przewodniku.
Pliki danych
Pliki danych to pliki w formacie JSON lub pb3 używane do przesyłania danych o asortymencie do Centrum działań. Dzięki temu możesz przesłać wszystkie swoje dane naraz, aby zaktualizować informacje o sprzedawcach, usługach i przedziałach dostępności za pomocą przesyłania przez SFTP.
Interfejs Maps Booking API
Interfejs Maps Booking API umożliwia aktualizowanie obiektów w systemie Actions Center między kolejnymi przesłaniami plików danych, aby zapewnić aktualność informacji. Interfejs API umożliwia też anulowanie rezerwacji dokonanych za pomocą pełnej integracji Zarezerwuj z Google.
Aktualizacje w czasie rzeczywistym są implementowane za pomocą wywołań REST.
Serwer rezerwacji
Aby umożliwić kompleksową integrację Centrum akcji 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 REST. Wszystkie nowe integracje powinny używać interfejsu API w wersji 3.
Ta sekcja określa pliki danych używane do przesyłania danych o asortymencie do Centrum działań. Zawartość plików danych określa, które usługi są dostępne i kiedy są dostępne.
Aby dowiedzieć się, jak nam udostępnić te pliki danych, zapoznaj się z tekstem Pliki referencyjne i przykłady.
Struktura plików danych o asortymencie jest definiowana przez interfejs Google Maps Booking API.
Ten plik danych jest wymagany w przypadku każdej integracji:
- Plik danych sprzedawców: zawiera dane opisujące Twoich sprzedawców.
Dodatkowo do pełnej integracji wymagane są dodatkowo 2 poniższe pliki danych.
- Plik danych o usługach: opisuje usługi świadczone przez Twoich sprzedawców.
- Plik danych o dostępności: zawiera listę przedziałów dostępności usług świadczonych przez sprzedawców.
Niektóre pola w tych plikach danych są wymagane, a inne opcjonalne. Wszystkie pola oznaczone jako opcjonalne mogą zostać pominięte w pliku danych, gdy są puste.
Format plików danych jest opisany za pomocą składni bufora protokołu 3. Plik danych możesz przesłać w postaci binarnej serializacji danych bufora protokołu w formacie Pb3 lub jako pochodny JSON. Zalecamy przesyłanie plików danych w formacie JSON.
Zalecamy skompresowanie plików danych za pomocą narzędzia gzip przed ich przesłaniem.
Ten przewodnik dotyczy buforów protokołów Actions Center. Ogólne informacje o tym, jak używać buforów protokołów do generowania pliku pb3, znajdziesz w tym przykładzie w Javie.