StreloБаза знанийВ кабинет

Как читать и писать данные в Google Таблицу из сценария

Нода «Google Таблицы» (она же Google Sheets, гугл-таблицы, экспорт в таблицу) читает и записывает данные в вашу Google Таблицу прямо во время прохождения пользователем сценария. Можно добавить строку, найти запись, обновить ячейки, прочитать диапазон, удалить строку или получить список листов. Результат сохраняется в п

Что нужно сделать до начала

Главное - открыть таблицу для сервисного аккаунта Strelo. Это делается один раз для каждой таблицы:

  1. В панели ноды скопируйте email сервисного аккаунта (кнопка копирования рядом с адресом).
  2. Откройте вашу Google Таблицу в браузере.
  3. Нажмите «Настройки доступа» (кнопка «Поделиться» в правом верхнем углу).
  4. Вставьте скопированный email и выберите роль Редактор.
  5. Нажмите «Поделиться». Strelo работает через свой служебный аккаунт, а не через ваш Google-вход. Поэтому авторизовываться в Google отдельно не нужно - достаточно один раз расшарить таблицу. Один и тот же email подходит для всех ваших таблиц.
Здесь будет скриншотS-8.3
скопируйте email сервисного аккаунта и добавьте его Редактором в Google Таблице
редактор сценария, панель ноды «Google Таблицы» · открыть страницу
Снять: правая панель нод с блоком-инструкцией про email сервис-аккаунта (зеленая рамка), кнопкой копирования email, полем «Операция», полем «Ссылка на таблицу или ID»
Выделить: блок с email сервис-аккаунта и кнопкой копирования

Нода доступна на тарифе Pro и выше. На Free заблокирована.

Пошагово: добавить строку в таблицу

  1. В левой палитре редактора, группа «Интеграции», найдите блок «Google Таблицы» и перетащите на холст.
  2. Соедините с предыдущим шагом (нодой, которая уже собрала нужные данные).
  3. Кликните по ноде - откроется панель.
  4. Скопируйте email сервисного аккаунта и добавьте его в таблицу (если не делали раньше).
  5. В поле «Операция» выберите «Добавить строку».
  6. В поле «Ссылка на таблицу или ID» вставьте полный адрес таблицы вида https://docs.google.com/spreadsheets/d/... или только ID. Поле принимает {{переменные}}.
  7. В поле «Лист (вкладка)» введите название вкладки (например Заявки). Пустое значение = первый лист.
  8. Галка «Первая строка - заголовки» включена по умолчанию: тогда колонки можно указывать по названию заголовка, а не буквой.
  9. В блоке «Данные (колонка -> значение)» нажмите «Добавить» и заполните пары: слева - буква колонки (A) или имя заголовка (Email), справа - значение или {{переменная}}. Добавьте столько пар, сколько нужно.
  10. Сохраните сценарий.
Здесь будет скриншотS-8.4
задайте, какие данные в какие колонки записать
редактор сценария, панель «Google Таблицы», операция «Добавить строку» · открыть страницу
Снять: поля «Операция» = «Добавить строку», «Ссылка на таблицу», «Лист», галка «Первая строка - заголовки», блок «Данные» с парами колонка - значение
Выделить: блок «Данные» с примером заполнения пар

Все доступные операции

ОперацияЧто делаетВыходные переменные
Добавить строкуДобавляет новую строку с заданными данными{{sheet_added}}, {{sheet_range}}
Найти строкиИщет строки по значению в колонке{{sheet_found}}, {{sheet_row}}, {{sheet_count}}, {{sheet_<заголовок>}}
Обновить строкуНаходит строку и изменяет значения колонок{{sheet_updated}}, {{sheet_row}}
Получить диапазонЧитает ячейки в диапазоне (например A1:C10){{sheet}} (все), {{sheet_value}} (первая)
Удалить строкуНаходит строку и удаляет ее{{sheet_deleted}}, {{sheet_row}}
Очистить диапазонОчищает значения ячеек{{sheet_cleared}}
Список листовВозвращает названия всех вкладок{{sheet}} (через запятую), {{sheet_count}}

Имя переменных формируется из поля «Имя переменной для результата» (по умолчанию sheet). Если вы введете туда lead - переменные будут {{lead_found}}, {{lead_row}} и т.д.

Как проверить: нашлась строка или нет?

Нода не ветвится сама. После нее нужна нода «Условие», которая проверяет значение переменной {{sheet_found}}:

  • {{sheet_found}} = true - строка нашлась.
  • {{sheet_found}} = false - не нашлась. По результату «Условие» направляет сценарий по нужной ветке.

Поиск по номеру строки напрямую

Для операций «Обновить строку» и «Удалить строку» можно указать номер строки вместо поиска: заполните поле «...или номер строки напрямую» (например 5 или {{sheet_row}}). Это удобно, если номер уже известен из предыдущего шага «Найти строки».

Если что-то не работает

  • Ошибка доступа / права в {{sheet_error}}. Таблица не расшарена на email сервисного аккаунта или расшарена с правами «Читатель» вместо «Редактор». Откройте настройки доступа таблицы и добавьте email как Редактора.
  • {{sheet_error}} про «Не указана таблица». Поле ссылки пустое или переменная в нем не подставилась. Вставьте корректную ссылку или ID; если используете {{переменную}}, убедитесь, что она заполнена выше по сценарию.
  • «Найти строки» всегда возвращает {{sheet_found}} = false. Не та колонка поиска или не тот лист. Проверьте имя заголовка или букву колонки, соответствие галки «заголовки» реальной таблице и правильное название листа.
  • «Добавить строку» пишет данные не в те колонки. Колонки заданы буквами при включенных заголовках или наоборот. При включенной галке «заголовки» указывайте имена заголовков, при выключенной - буквы (A, B, C).
  • «Обновить / Удалить строку» ничего не меняет. Ни поиск, ни номер строки не дали результата. Проверьте условие поиска или корректность номера строки.
  • Имя заголовка не превратилось в ожидаемую переменную. Пробелы и спецсимволы в заголовке заменяются на _ и приводятся к нижнему регистру. Подсказка под полем «Имя переменной» показывает точные имена переменных.
  • Частые ошибки при бурных рассылках. Google Sheets API ограничивает частоту запросов. При высокой нагрузке операции могут временно откланяться - проверяйте {{sheet_error}}.

Лимиты и тариф

  • Доступна на Pro, Business, Enterprise. На Free заблокирована.
  • Доступ к каждой таблице открывается вручную (через «Поделиться»). Один email сервисного аккаунта работает для всех таблиц.
  • Поиск охватывает столбцы от A до ZZ. Очень большие таблицы обрабатываются медленнее.
  • Нода не отправляет сообщений пользователю - платформенных лимитов Telegram у нее нет.

Не нашли ответ?

Спросите ИИ-ассистента или напишите живой поддержке - поможем разобраться.

Спросить StreloAIПоддержка в Telegram