Реакции — это действия, которые может выполнять бот.
В категории Google есть три реакции:
- ReadGoogleTable — чтение данных
- WriteGoogleTable — запись данных
- ClearGoogleTable — очистка данных
⚠️ Все реакции работают с учётом общего лимита — 10 запросов в секунду на одного бота.
1. ReadGoogleTable — чтение данных
Что делает
Бот читает данные из указанной ячейки, строки, столбца или диапазона таблицы.
Прочитанные данные сохраняются в переменную google.table — вы можете использовать их дальше в сценарии.
Обязательные параметры
| Параметр | Что это | Пример |
|---|---|---|
| Выбор таблицы | Из списка таблиц, подключённых к боту | Выбор из выпадающего списка |
| Адрес | Что именно читать в A1-нотации | A1, A1:C5, Sheet1!A1 |
Дополнительные настройки
| Настройка | Варианты | Что делает |
|---|---|---|
| ValueRenderOption | FORMATTED_VALUE (по умолчанию) |
Возвращает то, что видит пользователь: «1 500,00 р» |
UNFORMATTED_VALUE |
Возвращает сырое значение: 1500 |
|
FORMULA |
Возвращает формулу: «=SUM(A1:A10)» |
|
| MajorDimension | ROWS (по умолчанию) |
Данные группируются по строкам: первая строка → первый массив |
COLUMNS |
Данные группируются по столбцам: первый столбец → первый массив |
Как указывать адрес (A1-нотация)
| Пример | Что означает |
|---|---|
A1 |
Ячейка A1 на первом листе |
A1:C5 |
Диапазон от A1 до C5 |
A:C |
Все ячейки в столбцах A, B, C |
1:3 |
Все ячейки в строках 1, 2, 3 |
Sheet1!A1 |
Ячейка A1 на листе «Sheet1» |
A1:A |
Столбец A от строки 1 до конца |
📌 Если имя листа не указано, берётся первый лист таблицы.
Результат
Прочитанные данные сохраняются в контекст по пути google.table.
Пример использования:
Реакция: ReadGoogleTable → читает таблицу «Клиенты», адрес A:B
Реакция: SendMessage → текст: «Первый клиент: google.table.0.0,телефон:{google.table.0.0}, телефон: google.table.0.0,телефон:{google.table.0.1}»
Важно
- ✅ Чтение данных не изменяет таблицу
- ❌ Если адрес указан неверно, бот вернёт ошибку
- ⏱ Лимит — 10 запросов/сек
2. WriteGoogleTable — запись данных
Что делает
Бот записывает данные в таблицу.
Режимы работы
| Режим | Что делает | Когда использовать |
|---|---|---|
| Новая строка (по умолчанию) | Добавляет новую строку в конец таблицы | Добавление новых записей: клиенты, заказы, ответы на опросы |
| Диапазон | Записывает данные по указанному адресу | Обновление конкретных ячеек, перезапись диапазона |
Обязательные параметры
| Параметр | Что это |
|---|---|
| Выбор таблицы | В какую таблицу записывать |
| Режим работы | «Новая строка» или «Диапазон» |
Что записывать — два способа
Выберите один из двух способов:
| Способ | Описание | Плюсы | Минусы |
|---|---|---|---|
| Конвертер | Используете заранее созданный шаблон | Не нужно вводить данные вручную | Нужно создать конвертер заранее |
| Ручные данные | Вводите данные в формате JSON или YAML | Гибко, можно записать что угодно | Нужно знать JSON / YAML |
📌 Когда вы выбираете конвертер, поле для ручного ввода скрывается.
Параметр «Адрес»
Используется только в режиме «Диапазон» и там обязателен.
| Источник данных | Как указывается адрес |
|---|---|
| Ручные данные | Полный A1-адрес: A1, B2:D5, Sheet1!A1 |
| Конвертер | Только стартовая позиция: |
— при ориентации Rows → номер строки (например, 5) |
|
— при ориентации Columns → буква столбца (например, C) |
Важное ограничение
Режим «Новая строка» добавляет только строки. Поэтому:
| Ориентация конвертера | Можно ли использовать «Новую строку» |
|---|---|
| Rows (строки) | ✅ Да |
| Columns (столбцы) | ❌ Нет → используйте режим «Диапазон» |
Дополнительные настройки
| Параметр | Варианты | Что делает |
|---|---|---|
| ValueInputOption | USER_ENTERED (по умолчанию) |
Данные интерпретируются как при ручном вводе: =A1+B1 → формула, 1.5 → число, 01.01.2024 → дата |
RAW |
Данные сохраняются как есть, без интерпретации | |
| MajorDimension | ROWS (по умолчанию) |
Данные группируются по строкам |
COLUMNS |
Данные группируются по столбцам |
Как вводить данные вручную
JSON
Одна запись (по порядку столбцов):
["Анна", 22, "anna@example.com"]
Несколько записей:
[["Анна", 22, "anna@example.com"], ["Пётр", 28, "petr@example.com"]]
Одна запись с указанием столбцов:
{"A": "Анна", "B": 22, "C": "anna@example.com"}
Несколько записей с указанием столбцов:
[{"A": "Анна", "B": 22, "D": "anna@example.com"}, {"A": "Пётр", "B": 28, "D": "petr@example.com"}]
YAML
Одна запись (по порядку):
- Анна
- 22
- anna@example.com
Несколько записей (по порядку):
- - Анна
- 22
- anna@example.com
- - Пётр
- 28
- petr@example.com
Одна запись с указанием столбцов:
A: Анна
B: 22
C: anna@example.com
Несколько записей с указанием столбцов:
- A: Анна
B: 22
C: anna@example.com
- A: Пётр
B: 28
C: petr@example.com
Важно
- ⚠️ Запись данных изменяет таблицу — будьте осторожны
- ❌ Неверный адрес → бот вернёт ошибку
- ⏱ Лимит — 10 запросов/сек
3. ClearGoogleTable — очистка данных
Что делает
Бот очищает данные в указанном диапазоне таблицы.
⚠️ Очистка удаляет содержимое ячеек, но не удаляет сами ячейки. Структура таблицы (столбцы, строки, форматирование) сохраняется.
Обязательные параметры
| Параметр | Что это | Пример |
|---|---|---|
| Выбор таблицы | Из списка таблиц, подключённых к боту | Выбор из выпадающего списка |
| Адрес | Что именно очищать в A1-нотации | A1, A1:C5, Sheet1!A1, A:C |
Как указывать адрес (A1-нотация)
| Пример | Что очистится |
|---|---|
A1 |
Только ячейка A1 |
A1:B5 |
Диапазон от A1 до B5 |
A:C |
Все ячейки в столбцах A, B, C |
1:3 |
Все ячейки в строках 1, 2, 3 |
Sheet1!A1 |
Ячейка A1 на листе «Sheet1» |
A1:A |
Столбец A от строки 1 до конца |
Примеры использования
Пример 1 — очистить только одну ячейку
- Таблица: «Настройки»
- Адрес:
B2 - Результат: Очистится только ячейка B2
Пример 2 — очистить целый столбец
- Таблица: «Клиенты»
- Адрес:
C:C - Результат: Очистится весь столбец C
Пример 3 — очистить диапазон
- Таблица: «Отчёт»
- Адрес:
A1:D20 - Результат: Очистятся все ячейки в прямоугольнике от A1 до D20
Важно
- 🔴 Очистка необратима — данные нельзя восстановить через бота (только через историю версий Google Таблиц)
- 🧹 Если очистить всю таблицу (
A:Zили1:1000), структура сохранится, но все данные будут удалены - ❌ Неверный адрес → бот вернёт ошибку
- ⏱ Лимит — 10 запросов/сек
Советы
- ✅ Перед очисткой проверьте, что выбрана правильная таблица и правильный адрес
- 🔄 Используйте очистку вместе с записью: сначала очистить диапазон, потом записать новые данные
- 🧪 Для тестирования используйте отдельную тестовую таблицу, а не боевую
🔗 Связанные разделы
| Раздел | Описание |
|---|---|
| Google Таблицы | Настройка подключения и управление таблицами |
| Конвертер | Настройка формата данных для записи |
| A1-нотация | Справочник по адресам |
| Лимиты Google | Ограничения по запросам |