Вам необходим сервер бронирования, чтобы Центр действий мог совершать обратные вызовы для создания и обновления бронирований от вашего имени. Это позволит Центру действий создавать встречи, бронирования и резервирования от вашего имени.
Информацию о настройке подключения к серверам Sandbox и Production Booking Server см. в разделе Настройка учетных данных сервера Booking Server .
Прежде чем перейти к обновлениям в режиме реального времени, выполните следующие задачи по подготовке сервера бронирования:
- Загрузка страницы BatchAvailabilityLookup готова
- Слот BatchAvailabilityLookup нажимает «Готово»
- CreateBooking Ready
- Обновление: Готово к бронированию
- Включите проверку доступности в настройках Центра действий. Функции учетной записи.
Каждая задача считается выполненной и становится зелёной после отправки точной информации об инвентаре в режиме реального времени на сервер бронирования Booking Server через процесс бронирования Sandbox. Контрольные точки Booking Server анализируются в течение 14 дней.
Реализовать интерфейс REST API
Реализовать API-интерфейс на основе REST . Это позволит Google отправлять запросы к серверу бронирования по протоколу HTTPS.
Для реализации API-интерфейса настройте сервер разработки или сервер бронирования Sandbox, подключающийся к среде Sandbox Центра действий. Переходите в производственную среду только после полного тестирования сервера Sandbox.
Все запросы Google к серверу бронирования относятся к URL-адресу сервера бронирования, указанному на странице сервера бронирования . Например, если ваш URL-адрес — api.example.com/google , то все запросы HealthCheck будут отправляться на api.example.com/google/v3/HealthCheck .
Убедитесь, что для обеих сред — «песочницы» и «производства» — настроена правильная конечная точка Booking Server с помощью переключателя сред.
Безопасность и аутентификация
Весь обмен данными с вашим сервером бронирования осуществляется по протоколу HTTPS с использованием базовой аутентификации. Для настройки сервера мы рекомендуем использовать общедоступный инструмент проверки SSL или TLS, например, тест SSL-сервера Qualys .
Все запросы Google к вашему серверу бронирования проходят базовую аутентификацию HTTPS. Вы можете ввести данные базовой аутентификации, пароль и имя пользователя вашего сервера бронирования на странице настроек сервера бронирования в Центре действий . Учётные данные необходимо менять каждые шесть месяцев.
Создайте свой сервер бронирования
Сервер бронирования определяет, как интеграция взаимодействует с вашей системой, а также выполняет или обновляет бронирования. Чтобы настроить подключение к серверам бронирования Sandbox и Production, см. раздел «Настройка учётных данных сервера бронирования» .
Каждый ответ вашего сервера бронирования на запрос сервиса «Забронировать через Google» должен содержать точную информацию о наличии мест в режиме реального времени. В следующей таблице представлены методы реализации каждого варианта и ссылки на форматы протоколов сервиса:
| Метод | Определение | Ответ | HTTP-запрос |
|---|---|---|---|
Загрузка страницы BatchAvailabilityLookup | Когда пользователь нажимает кнопку «Зарезервировать столик для вашего продавца», при загрузке страницы вызывается запрос Полезная нагрузка содержит несколько слотов, которые основаны на ваших последних загрузках в ленту, которые сервис «Зарезервировать через Google» считает доступными. | Ответ должен включать все запросы на слоты и их текущую доступность. Это предотвращает отображение недоступных слотов. | POST/v3/BatchAvailabilityLookup/ |
Щелчок слота BatchAvailabilityLookup | Когда пользователю предоставляются доступные слоты для бронирования и он нажимает на слот, для нажатия на слот вызывается запрос BatchAvailabilityLookup . | Ответ должен отражать текущую фактическую доступность слота. Если слот был забронирован до нажатия кнопки, верните ответ о его недоступности. | POST/v3/BatchAvailabilityLookup/ |
CreateBooking | Когда пользователь подтверждает, что хочет забронировать выбранный временной интервал в модальном окне бронирования, отправляется запрос CreateBooking . | Ответ должен отражать успешность или неудачность бронирования. Если бронирование не удалось, необходимо вернуть конкретную причину. Например, слот был забронирован до вызова ответа В случае успешного бронирования ответ включает уникальный | POST /v3/CreateBooking/ |
UpdateBooking | После бронирования через сервис «Забронировать через Google» пользователь может изменить его. При обновлении или отмене бронирования отправляется запрос UpdateBooking . | Как и ответ CreateBooking , ваш ответ UpdateBooking должен отражать успешность бронирования или возвращать конкретную причину неудачи. | POST /v3/UpdateBooking/ |
HealthCheck | Центр действий регулярно обращается к вашему серверу бронирования, чтобы убедиться, что ваша инфраструктура активна и работает. | Используйте код статуса HTTP для отображения статуса обслуживания вашего сервера. Возвращайте код статуса HTTP 200, если сервер активен и работает успешно. Чтобы сообщить об ошибке или временно отключить интеграцию, верните соответствующий код статуса HTTP, отличный от 2xx. | ПОЛУЧИТЬ /v3/HealthCheck/ |
Процесс бронирования в песочнице
Чтобы просмотреть процесс бронирования в Sandbox, перейдите в представление «Инвентарь» в Центре действий. В столбце RwG - E2E представления «Инвентарь» отображается активная (в Sandbox) ссылка на процесс бронирования в Sandbox для продавцов Sandbox, которые соответствуют требованиям и будут доступны в будущем.
Ниже перечислены действия в процессе бронирования:
- При нажатии ссылки RwG - E2E инициируется запрос
BatchAvailabilityLookupпри загрузке страницы и отображается известная доступность продавца. - При нажатии на время бронирования активируется запрос
BatchAvailabilityLookupпо щелчку слота и отображается модальное окно бронирования. - Завершите бронирование с помощью модального окна бронирования, чтобы отправить запрос
CreateBooking. - После завершения бронирования в среде Sandbox на учетную запись, использованную для создания бронирования, будет отправлено подтверждение по электронной почте с данными бронирования.
- Чтобы запустить метод
UpdateBooking, измените или отмените бронирование из электронного письма.
HealthCheck
Обязательно реализуйте метод HealthCheck в Sandbox и Production. Этот метод возвращает статус работоспособности вашего сервера бронирования. Он позволяет Google непрерывно отслеживать состояние обслуживания вашего сервера бронирования.
Запрос : Нет
Возвращаемое значение : нет
Используйте код статуса HTTP для указания статуса обслуживания вашего сервера.
Если сервер активен и работает успешно, верните код статуса HTTP 200 или, чтобы указать на ошибку, верните один из кодов статуса HTTP .
Реализовать интерфейс REST API
Реализовать API-интерфейс на основе REST . Это позволит Google отправлять запросы к серверу бронирования по протоколу HTTPS.
Для реализации API-интерфейса настройте сервер разработки или сервер бронирования Sandbox, подключающийся к среде Sandbox Центра действий. Переходите в производственную среду только после полного тестирования сервера Sandbox.
Все запросы Google к серверу бронирования относятся к URL-адресу сервера бронирования, указанному на странице сервера бронирования . Например, если ваш URL-адрес — api.example.com/google , то все запросы HealthCheck будут отправляться на api.example.com/google/v3/HealthCheck .
Убедитесь, что для обеих сред — «песочницы» и «производства» — настроена правильная конечная точка Booking Server с помощью переключателя сред.
Безопасность и аутентификация
Весь обмен данными с вашим сервером бронирования осуществляется по протоколу HTTPS с использованием базовой аутентификации. Для настройки сервера мы рекомендуем использовать общедоступный инструмент проверки SSL или TLS, например, тест SSL-сервера Qualys .
Все запросы Google к вашему серверу бронирования проходят базовую аутентификацию HTTPS. Вы можете ввести данные базовой аутентификации, пароль и имя пользователя вашего сервера бронирования на странице настроек сервера бронирования в Центре действий . Учётные данные необходимо менять каждые шесть месяцев.
Создайте свой сервер бронирования
Сервер бронирования определяет, как интеграция взаимодействует с вашей системой, а также выполняет или обновляет бронирования. Чтобы настроить подключение к серверам бронирования Sandbox и Production, см. раздел «Настройка учётных данных сервера бронирования» .
Каждый ответ вашего сервера бронирования на запрос сервиса «Забронировать через Google» должен содержать точную информацию о наличии мест в режиме реального времени. В следующей таблице представлены методы реализации каждого варианта и ссылки на форматы протоколов сервиса:
| Метод | Определение | Ответ | HTTP-запрос |
|---|---|---|---|
Загрузка страницы BatchAvailabilityLookup | Когда пользователь нажимает кнопку «Зарезервировать столик для вашего продавца», при загрузке страницы вызывается запрос Полезная нагрузка содержит несколько слотов, которые основаны на ваших последних загрузках в ленту, которые сервис «Зарезервировать через Google» считает доступными. | Ответ должен включать все запросы на слоты и их текущую доступность. Это предотвращает отображение недоступных слотов. | POST/v3/BatchAvailabilityLookup/ |
Щелчок слота BatchAvailabilityLookup | Когда пользователю предоставляются доступные слоты для бронирования и он нажимает на слот, для нажатия на слот вызывается запрос BatchAvailabilityLookup . | Ответ должен отражать текущую фактическую доступность слота. Если слот был забронирован до нажатия кнопки, верните ответ о его недоступности. | POST/v3/BatchAvailabilityLookup/ |
CreateBooking | Когда пользователь подтверждает, что хочет забронировать выбранный временной интервал в модальном окне бронирования, отправляется запрос CreateBooking . | Ответ должен отражать успешность или неудачность бронирования. Если бронирование не удалось, необходимо вернуть конкретную причину. Например, слот был забронирован до вызова ответа В случае успешного бронирования ответ включает уникальный | POST /v3/CreateBooking/ |
UpdateBooking | После бронирования через сервис «Забронировать через Google» пользователь может изменить его. При обновлении или отмене бронирования отправляется запрос UpdateBooking . | Как и ответ CreateBooking , ваш ответ UpdateBooking должен отражать успешность бронирования или возвращать конкретную причину неудачи. | POST /v3/UpdateBooking/ |
HealthCheck | Центр действий регулярно обращается к вашему серверу бронирования, чтобы убедиться, что ваша инфраструктура активна и работает. | Используйте код статуса HTTP для отображения статуса обслуживания вашего сервера. Возвращайте код статуса HTTP 200, если сервер активен и работает успешно. Чтобы сообщить об ошибке или временно отключить интеграцию, верните соответствующий код статуса HTTP, отличный от 2xx. | ПОЛУЧИТЬ /v3/HealthCheck/ |
Процесс бронирования в песочнице
Чтобы просмотреть процесс бронирования в Sandbox, перейдите в представление «Инвентарь» в Центре действий. В столбце RwG - E2E представления «Инвентарь» отображается активная (в Sandbox) ссылка на процесс бронирования в Sandbox для продавцов Sandbox, которые соответствуют требованиям и будут доступны в будущем.
Ниже перечислены действия в процессе бронирования:
- При нажатии ссылки RwG - E2E инициируется запрос
BatchAvailabilityLookupпри загрузке страницы и отображается известная доступность продавца. - При нажатии на время бронирования активируется запрос
BatchAvailabilityLookupпо щелчку слота и отображается модальное окно бронирования. - Завершите бронирование с помощью модального окна бронирования, чтобы отправить запрос
CreateBooking. - После завершения бронирования в среде Sandbox на учетную запись, использованную для создания бронирования, будет отправлено подтверждение по электронной почте с данными бронирования.
- Чтобы запустить метод
UpdateBooking, измените или отмените бронирование из электронного письма.
HealthCheck
Обязательно реализуйте метод HealthCheck в Sandbox и Production. Этот метод возвращает статус работоспособности вашего сервера бронирования. Он позволяет Google непрерывно отслеживать состояние обслуживания вашего сервера бронирования.
Запрос : Нет
Возвращаемое значение : нет
Используйте код статуса HTTP для указания статуса обслуживания вашего сервера.
Если сервер активен и работает успешно, верните код статуса HTTP 200 или, чтобы указать на ошибку, верните один из кодов статуса HTTP .