## Шаг 1. Добавление узла Вебхук
После создания потока IoT Logic добавьте узел Вебхук и подключите его к триггеру, который инициирует передачу данных.
Узел Вебхук работает по принципу fire-and-forget. Это означает, что он немедленно отправляет HTTP-запрос при срабатывании, но не ожидает и не сохраняет ответ сервера.
После добавления узла Вебхук настройте его следующим образом.
#### URL
Введите URL веб-приложения Google Apps Script, связанного с таблицей Google Sheet, в которую вы хотите отправлять информацию.
#### Заголовки
Добавьте следующий HTTP-заголовок:
| Ключ | Значение |
| --------------- | ---------------- |
| Тип содержимого | application/json |
#### Тело
Тело запроса должно быть в формате JSON. Оно должно включать ключ аутентификации и любые данные, которые вы хотите отправить в Google Таблицы.
Пример:
*{*
*"key": "MY\_SUPER\_SECRET\_123",*
*"событие": "утренний отчет по топливу",*
*"device\_id": "{{device\_label}}",*
*"timestamp": "{{comb\_current\_time}}"*
*}*
Вы можете включить любые дополнительные атрибуты IoT Logic или параметры телеметрии, используя соответствующие заполнители.
Примечание: поле "key" обязательно, если ваш Google Apps Script использует общий секрет для аутентификации входящих запросов Вебхука. Замените "MY\_SUPER\_SECRET\_123" на секрет, настроенный в вашем Google Apps Script.
## Шаг 2. Настройте Google Таблицу
Откройте Google Таблицу, нажмите Extensions, а затем выберите Apps Script.
Это откроет файл Code.gs, в который вы добавите скрипт, отвечающий за получение запросов Вебхука и запись данных в электронную таблицу.
Следующий пример кода можно использовать для получения значений, отправленных из узла Вебхук, и добавления их в вашу Google Таблицу в виде новой строки.
*function doPost(e) {*
*var SECRET\_KEY = "MY\_SUPER\_SECRET\_123";*
*var data = JSON.parse(e.postData.contents);*
*if (data.key !== SECRET\_KEY) {*
*return ContentService.createTextOutput("Access Denied").setMimeType(ContentService.MimeType.TEXT);*
*}*
*var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();*
*sheet.appendRow(\[*
*new Date(),*
*data.name || "",*
*data.device\_id || "",*
*data.longitud || "",*
*data.latitud || ""*
*]);*
*return ContentService.createTextOutput("Успех").setMimeType(ContentService.MimeType.TEXT);*
*}*
**Примечание**: Замените приведенный выше пример кода скриптом, указанным ниже. Вы также можете настроить поля так, чтобы они соответствовали данным, отправляемым из вашего Вебхук IoT Logic.
Скрипт выше работает как HTTP POST-эндпоинт, который принимает запросы, отправляемые из узла Вебхук IoT Logic.
При каждом поступлении запроса скрипт сначала проверяет общий секрет (SECRET\_KEY), чтобы гарантировать, что записывать данные в Google Sheet разрешено только авторизованным запросам Вебхук. Если проверка подлинности успешна, JSON-полезная нагрузка разбирается, и указанные параметры — такие как временная метка приема, имя устройства, ID устройства, долгота, широта или любые другие телеметрические значения — автоматически добавляются в электронную таблицу как новая строка.
Наконец, скрипт возвращает ответ, указывающий, была ли операция успешно выполнена (Успех) или отклонена из-за недействительного ключа аутентификации (Доступ запрещен).
Важно: Имена полей, используемые в скрипте, должны в точности совпадать с именами параметров, передаваемыми Вебхуком IoT Logic. К каждому значению обращаются с помощью синтаксиса data.\
Выберите New Deployment, а затем выберите Web App в меню типа развертывания. Процесс развертывания может занять несколько минут. После его завершения будет сгенерирован URL Web App. Скопируйте этот URL и вставьте его в поле URL Узел Вебхук в вашем потоке IoT Logic. URL Web App — это конечная точка, которая будет принимать HTTP POST-запросы, отправляемые Узел Вебхук.
#### Обновление Apps Script
Если позже вам потребуется изменить Apps Script, не нужно создавать новое развертывание.
Вместо этого нажмите Deploy → Manage Deployments, выберите существующее развертывание и нажмите Edit (значок карандаша). После сохранения и повторного развертывания обновленной версии внесенные в сценарий изменения сразу вступят в силу, при этом URL Web App останется тем же.
Это позволяет обновлять сценарий без необходимости изменять конфигурацию Вебхук в IoT Logic.
После выполнения всех шагов, описанных в этом руководстве, соединение между IoT Logic и Google Sheets должно быть успешно установлено.
Эта интеграция предоставляет простой и эффективный способ записывать телеметрические данные, внешние параметры или пользовательские атрибуты IoT Logic для отчетности, анализа, аудита или интеграции с другими инструментами Google Workspace.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://navixy.com/docs/expert-center/ru/faq-and-troubleshooting/iot-logic/how-to-connect-an-iot-logic-webhook-node-to-google-sheets.md?ask=