EnotPRO Logo EnotPRO

Google

Реакции — это действия, которые может выполнять бот.

В категории Google есть три реакции:

  1. ReadGoogleTable — чтение данных
  2. WriteGoogleTable — запись данных
  3. 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 запросов/сек

Советы

  1. Перед очисткой проверьте, что выбрана правильная таблица и правильный адрес
  2. 🔄 Используйте очистку вместе с записью: сначала очистить диапазон, потом записать новые данные
  3. 🧪 Для тестирования используйте отдельную тестовую таблицу, а не боевую

🔗 Связанные разделы

Раздел Описание
Google Таблицы Настройка подключения и управление таблицами
Конвертер Настройка формата данных для записи
A1-нотация Справочник по адресам
Лимиты Google Ограничения по запросам

© 2025 EnotPRO. Все права защищены.