Подключение Google Sheets (прямая интеграция с Google Таблицами)

В статье разберём как подключить Google Sheets к боту и считывать или записывать значения ячеек.

Примеры использования интеграции с таблицами Google:

Подключение Google аккаунта 

Для подключения Google аккаунта необходимо открыть проект с ботом в личном кабинете, перейти на вкладку Настройки, выбрать раздел Интеграции и нажать на кнопку SIGN IN WITH GOOGLE.

В появившемся окне от google нажмите Продолжить

Поставьте галочку напротив "Создание, просмотр, изменение и удаление ваших таблиц Google" и нажмите Продолжить

При успешном подключении Google аккаунта он отобразится в списке.

Важно! Вы можете подключить несколько Google аккаунтов.

В случае необходимости отозвать разрешения воспользуйтесь страницей: Приложения, у которых есть доступ к аккаунту.


Возможности интеграции

После подключения Google аккаунта возможностями интеграции можно пользоваться в следующих местах:

  • Действия — раздел в Командах, Условиях и Постах, типы действий:

    • Создать строку — добавляет новую строку в самый конец таблицы и заполняет указанные столбцы (идеально для сбора заявок, регистраций и логов).

    • Обновить строку — находит строку по заданному фильтру (например, по ID пользователя) и меняет значения в выбранных столбцах.

    • Очистить строку — стирает содержимое ячеек в найденной строке, но оставляет саму строку на месте (нумерация и формулы в других строках не сдвигаются).

    • Удалить строку — физически вырезает строку из таблицы, поднимая все строки снизу на одну позицию вверх.

    • Создать лист — позволяет автоматически создать новый лист.

    • Удалить лист — удаляет выбранный лист.
       

  • Проверка — раздел у Условий, типы проверок:

    • Проверить строку — позволяет проверить значение в определенной строке и ячейке.
       

  • Интегрированная переменная — новый подтип для интегрированных переменных, позволяющий обращаться к конкретной ячейке или делать поиск строкам

Важно! Google Sheets имеют лимит на количество запросов к таблицам — 60 запросов в минуту на отправку и 60 запросов в минуту на запись. 


Разберём общие настройки для всех типов.

Настройка интеграции

Все блоки с интеграцией можно разделить на три этапа: 

  1. Выбор аккаунта, таблицы и листа

  2. Фильтр для поиска нужных строк или ввод адреса

  3. Запись значений

Выбор аккаунта, таблицы и листа

Этап состоит из трёх полей: выбор аккаунта, ссылка на таблицу и название листа. При вводе названий происходит поиск по таблицам или листам. Напротив каждого поля есть кнопка для обновления списка.

Фильтр для поиска нужных строк или ввод адреса

2c0ecffbc624874c634b6b4fd27d1174.png

Разберём каждое поле:

  • Строка — позволяет выбрать по какому типу искать нужные строки: через фильтры или введя конкретный адрес (можно вставить переменную)

  • Поиск — позволяет задать фильтры с типом “И” и “ИЛИ”, рассмотрим поля фильтров:

    • Столбец для поиска — название столбца и его буква

    • Формат значения — текст, число, дата или проверка на наличие значения

Важно! Первая строка каждой таблицы является заголовком и не участвует в поиске.

  • Дополнительные настройки:

    • Сортировка по столбцу и Сортировка ответов — позволяют отсортировать полученные ответы и на основе сортировки применить запись
      Например: для задачи, в которой нужно изменить значение у пользователя с наибольшим балансом необходимо выбрать сортировку по столбцу “Баланс”, а сортировку ответов “По убыванию”.

    • Варианты поиска — Первый найденный, Все или Задать количество

Запись значений

98bf24e07ddc43c9ba69f6715ed647a1.png

В данном этапе отображаются все столбцы, у которых заполнен заголовок (первая строка).

Правила работы с этапом:

  1. Работа с записью значений происходит по правилам выражений, подробнее: Правила написания выражения или формулы

  2. Если значение для ячейки не задано (пустое), то оно не будет изменено.

  3. Для очистки ячейки необходимо нажать на кнопку корзины.

  4. При использовании оператора “ = ” значение в ячейке будет перезаписано, а при использовании операторов “ + ”, “ - ”, “ * ”, “ / ” действие будет применено к значению в Google Таблице.

Важно! Значение с типом Число может работать со всеми операторами, значение с типом Текст только с операторами “ = ” и “ + ”, остальные типы только с оператором “ = ”.

Важно! Если ячейка имеет форматирование, то действие с ней произойдёт по правилам работы с Текстом (конкатенация). Например: в таблице находится ячейка со значением 100 и форматом валюта “ ₽ ”, при сложении её со значением 100 в ячейку будет записано "100 ₽100", а форматирование у ячейки пропадёт.


Практические примеры

Сохранение новой заявки от пользователя

Задача: Записать в таблицу данные клиента после прохождения опроса или нажатия кнопки.

  1. Создайте в Google Таблице столбцы: Дата, Telegram ID, Имя, Телефон, Запрос.

  2. В Puzzlebot откройте нужную команду с формой ввода → перейдите в Действия → добавьте действие Google Sheets → Создать строку.

  3. Выберите аккаунт, таблицу и лист.

  4. В блоке Запись значений заполните поля переменными:

    • Дата = {{CURRENT_DATE}} - системная переменная

    • Telegram ID = {{USER_ID_TEXT}} - системная переменная

    • Имя = {{FIRST_NAME_TEXT}} - системная переменная

    • Телефон = {{phone}} - ваша созданная переменная или переменная из формы ввода

    • Запрос = {{user_text}} - ваша созданная переменная или переменная из формы ввода


Проверка пользователя в таблице для доступа к боту

Задача: Пускать в бота только тех пользователей, чей Telegram ID уже внесён администратором в таблицу.

  1. В Google Таблице создайте столбец Telegram ID и внесите туда нужные идентификаторы.

  2. В puzzlebot создайте Условие → перейдите в раздел Проверка → выберите Google Sheets → Проверить строку.

  3. Настройте фильтр:

    • Столбец для поиска: выберите столбец Telegram ID

    • Формат значения: Текст

    • Тип условия: Полное совпадение

    • Фразы → {{USER_ID_TEXT}}

  4. В Условии в этом правиле ниже настройте Действие:

    • Добавить действие → Отправить команду или условие → Укажите название команды с доступом к главному меню.

    • Ниже в Исключающем правиле настройте действие → Отправить команду или условие → Укажите название команды с текстом «У вас нет доступа» или свой текст. Предварительно эти команды уже должны быть созданы.


Начисление или списание баллов

Задача: Начислить пользователю 150 бонусов за действие в боте.

  1. В действиях команды выберите Обновить строку.

  2. В блоке фильтра укажите: Столбец для поиска Telegram ID

  3. Формат значения: Текст

  4. Тип условия: Полное совпадение

  5. Фразы → {{USER_ID_TEXT}}

  6. В блоке Запись напротив столбца Баланс:

    • Выберите оператор + (прибавить)

    • Укажите значение: 150

  7. Значение в таблице автоматически увеличится на 150 после вызова пользователем команды с этим действием.

Алексей Алехно
Была ли страница полезна?