В этом разделе представлена более подробная информация о трех основных компонентах интеграции с Центром действий. Вы будете использовать каждый из них в шагах, описанных в комплексном руководстве .
Ленты
Фиды – это файлы в формате JSON или pb3 , используемые для передачи данных о вашем инвентаре в Центр действий. Это позволяет вам отправить все свои данные одновременно для обновления продавцов, услуг и слотов доступности с помощью загрузки по SFTP.
API бронирования карт
Maps Booking API позволяет обновлять объекты в системе Центра действий между отправками фидов, чтобы поддерживать актуальность информации. API также позволяет вам отменять бронирования, сделанные через систему резервирования со сквозной интеграцией Google.
Обновления в реальном времени реализуются с помощью вызовов REST .
Сервер бронирования
Чтобы комплексная интеграция Центра действий могла создавать бронирования от вашего имени, вам необходимо настроить сервер бронирования.
ОТДЫХ API
Версия v3 является последней версией API и поддерживает интерфейс на основе REST. Все новые интеграции должны использовать API версии 3.
В этом разделе указаны файлы каналов, используемые для передачи данных о вашем инвентаре в Центр действий. Содержимое ваших каналов определяет, какие услуги вы предоставляете, какие услуги доступны и когда они доступны.
Проверьте аккордеон «Ссылки и образцы» , чтобы узнать, как поделиться с нами этими каналами.
Структура фидов инвентаря определяется API бронирования Google Maps.
Следующий фид является обязательным для любой интеграции:
- Лента продавцов : содержит данные, описывающие ваших продавцов.
Кроме того, два следующих канала обязательны для сквозной интеграции.
- Фид услуг : описывает услуги, предоставляемые вашими продавцами.
- Лента доступности : содержит список доступных мест услуг, предоставляемых вашими продавцами.
Некоторые поля в этих фидах являются обязательными, а некоторые необязательными. Любое поле, помеченное как необязательное, можно исключить из ленты, если оно пустое.
Формат каналов описывается с использованием синтаксиса буфера протокола 3. У вас есть возможность загрузить файл каналов в виде двоичной сериализации данных буфера протокола в формате pb3 или в производном формате JSON. Мы рекомендуем загружать фиды в формате JSON.
Мы рекомендуем использовать gzip для сжатия каналов перед загрузкой.
Это руководство относится только к буферам протокола Центра действий. Для получения общей информации о том, как использовать буферы протокола для создания файла pb3, вот пример на Java .