В статье разберём как подключить Google Sheets к боту и считывать или записывать значения ячеек.
Примеры использования интеграции с таблицами Google:
Проверка пользователя по Google таблицам и выполнение действий с ним
Получение информации из Google таблицы по заданному значению
Создание заявки от пользователей с подтверждением или отклонением в ресурсе
Подключение Google аккаунта

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

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

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

При успешном подключении Google аккаунта он отобразится в списке.
Важно! Вы можете подключить несколько Google аккаунтов.
В случае необходимости отозвать разрешения воспользуйтесь страницей: Приложения, у которых есть доступ к аккаунту.
Возможности интеграции
После подключения Google аккаунта возможностями интеграции можно пользоваться в следующих местах:
Действия — раздел в Командах, Условиях и Постах, типы действий:
Создать строку — добавляет новую строку в самый конец таблицы и заполняет указанные столбцы (идеально для сбора заявок, регистраций и логов).
Обновить строку — находит строку по заданному фильтру (например, по ID пользователя) и меняет значения в выбранных столбцах.
Очистить строку — стирает содержимое ячеек в найденной строке, но оставляет саму строку на месте (нумерация и формулы в других строках не сдвигаются).
Удалить строку — физически вырезает строку из таблицы, поднимая все строки снизу на одну позицию вверх.
Создать лист — позволяет автоматически создать новый лист.
Удалить лист — удаляет выбранный лист.
Проверка — раздел у Условий, типы проверок:
Проверить строку — позволяет проверить значение в определенной строке и ячейке.
Интегрированная переменная — новый подтип для интегрированных переменных, позволяющий обращаться к конкретной ячейке или делать поиск строкам
Важно! Google Sheets имеют лимит на количество запросов к таблицам — 60 запросов в минуту на отправку и 60 запросов в минуту на запись.
Разберём общие настройки для всех типов.
Настройка интеграции
Все блоки с интеграцией можно разделить на три этапа:
Выбор аккаунта, таблицы и листа
Фильтр для поиска нужных строк или ввод адреса
Запись значений
Выбор аккаунта, таблицы и листа

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

Разберём каждое поле:
Строка — позволяет выбрать по какому типу искать нужные строки: через фильтры или введя конкретный адрес (можно вставить переменную)
Поиск — позволяет задать фильтры с типом “И” и “ИЛИ”, рассмотрим поля фильтров:
Столбец для поиска — название столбца и его буква
Формат значения — текст, число, дата или проверка на наличие значения
Важно! Первая строка каждой таблицы является заголовком и не участвует в поиске.
Дополнительные настройки:
Сортировка по столбцу и Сортировка ответов — позволяют отсортировать полученные ответы и на основе сортировки применить запись
Например: для задачи, в которой нужно изменить значение у пользователя с наибольшим балансом необходимо выбрать сортировку по столбцу “Баланс”, а сортировку ответов “По убыванию”.Варианты поиска — Первый найденный, Все или Задать количество
Запись значений

В данном этапе отображаются все столбцы, у которых заполнен заголовок (первая строка).
Правила работы с этапом:
Работа с записью значений происходит по правилам выражений, подробнее: Правила написания выражения или формулы
Если значение для ячейки не задано (пустое), то оно не будет изменено.
Для очистки ячейки необходимо нажать на кнопку корзины.
При использовании оператора “ = ” значение в ячейке будет перезаписано, а при использовании операторов “ + ”, “ - ”, “ * ”, “ / ” действие будет применено к значению в Google Таблице.
Важно! Значение с типом Число может работать со всеми операторами, значение с типом Текст только с операторами “ = ” и “ + ”, остальные типы только с оператором “ = ”.
Важно! Если ячейка имеет форматирование, то действие с ней произойдёт по правилам работы с Текстом (конкатенация). Например: в таблице находится ячейка со значением 100 и форматом валюта “ ₽ ”, при сложении её со значением 100 в ячейку будет записано "100 ₽100", а форматирование у ячейки пропадёт.
Практические примеры
Сохранение новой заявки от пользователя
Задача: Записать в таблицу данные клиента после прохождения опроса или нажатия кнопки.

Создайте в Google Таблице столбцы:
Дата,Telegram ID,Имя,Телефон,Запрос.В Puzzlebot откройте нужную команду с формой ввода → перейдите в Действия → добавьте действие Google Sheets → Создать строку.
Выберите аккаунт, таблицу и лист.
В блоке Запись значений заполните поля переменными:
Дата={{CURRENT_DATE}}- системная переменнаяTelegram ID={{USER_ID_TEXT}}- системная переменнаяИмя={{FIRST_NAME_TEXT}}- системная переменнаяТелефон={{phone}}- ваша созданная переменная или переменная из формы вводаЗапрос={{user_text}}- ваша созданная переменная или переменная из формы ввода
Проверка пользователя в таблице для доступа к боту
Задача: Пускать в бота только тех пользователей, чей Telegram ID уже внесён администратором в таблицу.

В Google Таблице создайте столбец
Telegram IDи внесите туда нужные идентификаторы.В puzzlebot создайте Условие → перейдите в раздел Проверка → выберите Google Sheets → Проверить строку.
Настройте фильтр:
Столбец для поиска: выберите столбец
Telegram IDФормат значения:
ТекстТип условия:
Полное совпадениеФразы →
{{USER_ID_TEXT}}
В Условии в этом правиле ниже настройте Действие:
Добавить действие → Отправить команду или условие → Укажите название команды с доступом к главному меню.
Ниже в Исключающем правиле настройте действие → Отправить команду или условие → Укажите название команды с текстом «У вас нет доступа» или свой текст. Предварительно эти команды уже должны быть созданы.
Начисление или списание баллов
Задача: Начислить пользователю 150 бонусов за действие в боте.


В действиях команды выберите Обновить строку.
В блоке фильтра укажите: Столбец для поиска
Telegram IDФормат значения:
ТекстТип условия:
Полное совпадениеФразы →
{{USER_ID_TEXT}}В блоке Запись напротив столбца
Баланс:Выберите оператор
+(прибавить)Укажите значение:
150
Значение в таблице автоматически увеличится на 150 после вызова пользователем команды с этим действием.