Как отправлять вебхуки из Google Forms

Включение вебхуков в Google Forms ​

Для начала установите дополнение Google Forms из Google Marketplace. Дополнение называется 'Email Notifications', но оно также включает поддержку отправки мгновенных push-уведомлений на любой URL-адрес вебхука.

Затем запустите дополнение и выберите Вебхуки для Google Forms из меню.

Нажмите кнопку Создать вебхук, чтобы интегрировать новый вебхук с вашими формами Google. У вас может быть несколько вебхуков, связанных с одной и той же формой Google, и она будет отправлять данные форм на все URL-адреса вебхуков при получении новой отправки формы.

Добавление URL-адреса вебхука и параметров запроса ​

На первом экране укажите уникальное имя для вашего вебхука (используется внутренне) и выберите метод HTTP-запроса. Скорее всего, вы будете использовать POST-запрос, но модуль вебхуков также поддерживает методы GET, PUT, PATCH и DELETE.

Затем укажите полный URL-адрес вебхука внешнего веб-сервиса, с которым вы хотите интегрировать Google Forms. Для тестирования я рекомендую использовать сервис webhook.site или requestbin.com, чтобы получить уникальный URL для проверки и тестирования ваших вебхуков.

Конфигурация URL-адреса вебхука

Раздел параметров запроса позволяет добавлять пользовательские параметры к URL-адресу вебхука. Например, если вы отправляете вебхуки из нескольких форм, вы можете добавить параметр {{Form Id}} к вашему URL, чтобы легко определить источник конкретного вызова вебхука.

Авторизация и аутентификация​

Вы можете настроить свой вебхук для включения секретного токена носителя или токена доступа для авторизации вызовов. Вы можете выполнить базовую аутентификацию с помощью логина и пароля или включить API-ключи в заголовки аутентификации.

Пользовательские заголовки​

Вы также можете включать пользовательские заголовки в ваши конечные точки вебхука. Ключи заголовка могут быть строками или числами и не должны содержать пробелы или другие недопустимые символы.

Тело запроса​

Тело запроса определяет полезную нагрузку (ответ формы и пользовательские данные), которая отправляется в веб-сервис при получении записи формы. Вы можете отправлять полезную нагрузку в различных форматах, включая JSON, данные формы, XML и другие.

Полезная нагрузка может содержать метаданные формы (например, ID формы, ID ответа, URL редактирования ответа) и ответы пользователя. Каждый вопрос должен быть добавлен как новая пара ключ-значение в теле запроса с заголовком ответа, заключенным в двойные фигурные скобки.

После того как вы закончите определение вашего вебхука, нажмите кнопку "Тест", и дополнение отправит HTTP-запрос на URL обратного вызова, используя данные формы из последнего полученного ответа вашей формы Google.

Нажмите "Сохранить", чтобы включить вебхук.