ReadGoogleTable
Что это за реакция
Реакция ReadGoogleTable позволяет боту читать данные из Google Таблицы.
Прочитанные данные сохраняются в переменную google.table. Дальше вы можете использовать их в сценарии — например, отправить пользователю, обработать или записать куда-то ещё.
Где используется
В сценариях бота, когда нужно:
- Проверить, есть ли пользователь в таблице
- Получить список товаров, заказов или клиентов
- Прочитать настройки или конфигурацию из таблицы
- Взять данные для отчёта
Какие параметры нужно указать
Обязательные
| Параметр | Что это | Пример |
|---|---|---|
| Выбор таблицы | Какую таблицу читать | Выбираете из списка подключённых таблиц |
| Адрес | Что именно читать | 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.
Дальше вы можете использовать их в сценарии через переменные.
Пример использования
Ситуация: У вас есть таблица с клиентами. В столбце A — имена, в столбце B — телефоны.
Вы настраиваете реакцию:
- Таблица: «Клиенты»
- Адрес:
A:B(читаем столбцы A и B) - ValueRenderOption:
FORMATTED_VALUE - MajorDimension:
ROWS
Бот прочитает таблицу и сохранит в google.table. Теперь вы можете, например, пройти по всем строкам и отправить каждому клиенту сообщение.
Важно
- Чтение данных не изменяет таблицу
- Если адрес указан неверно, бот вернёт ошибку
- Лимит — 10 запросов в секунду на одного бота