В этом разделе более подробно описаны 3 основных компонента интеграции с Центром действий. Каждый из них будет использоваться на этапах, описанных в комплексном руководстве .
Корма
Файлы в формате JSON или pb3 используются для передачи данных о вашем инвентаре в Центр действий. Это позволяет отправлять все данные одновременно для обновления информации о продавцах, услугах и доступных слотах с помощью загрузки по SFTP.
API бронирования карт
API Maps Booking позволяет обновлять объекты в системе Actions Center между отправками данных из фида, чтобы поддерживать актуальность информации. API также позволяет отменять бронирования, сделанные через сквозную интеграцию Reserve with Google.
Обновления в реальном времени реализуются с помощью REST-запросов .
Сервер бронирования
Для того чтобы интеграция с Центром действий создавала бронирования от вашего имени, необходимо настроить сервер бронирования.
REST API
Версия v3 — это последняя версия API, поддерживающая REST-интерфейс. Все новые интеграции должны использовать API версии v3.
В этом разделе указываются файлы данных, используемые для передачи информации о вашем инвентаре в Центр действий. Содержимое ваших файлов данных определяет, какие услуги вы предоставляете, какие услуги доступны и когда они доступны.
Чтобы узнать, как поделиться этими материалами с нами, перейдите в раздел «Ссылки и примеры» .
Структура данных об объектах размещения определяется API бронирования Google Maps.
Для любой интеграции требуется наличие следующего канала связи:
- Лента данных о продавцах : содержит информацию о ваших продавцах.
Кроме того, для сквозной интеграции обязательны следующие 2 канала передачи данных.
- Лента услуг : описывает услуги, предоставляемые вашими продавцами.
- Лента доступности : отображает временные интервалы доступности услуг, предоставляемых вашими продавцами.
В этих лентах некоторые поля обязательны для заполнения, а некоторые — необязательны. Любое поле, помеченное как необязательное, можно не включать в ленту, если оно пустое.
Формат данных описывается с использованием синтаксиса протокола Protocol Buffer 3. Вы можете загрузить файл данных в виде бинарной сериализации данных Protocol Buffer в формате pb3 или в производном формате JSON. Мы рекомендуем загружать данные в формате JSON.
Мы рекомендуем использовать gzip для сжатия файлов перед загрузкой.
Данное руководство относится к протоколу Protocol Buffers Центра действий. Для получения общей информации о том, как использовать Protocol Buffers для создания файла pb3, приведён пример на Java .