Google Таблицы это очень полезный инструмент, которым пользуется огромное количество человек. Более того создано огромное количество интеграций с ними, поэтому мы сейчас поговорим о том, как интегрировать Google Таблицы на платформу Botbrother и взаимодействовать с ней через Телеграм Бота.
Первым делом вам нужен любой аккаунт в Google, если у вас он есть, то воспользуйтесь им, если нет, то вам нужно зарегистрировать аккаунт в Google.com
Второе вам нужно перейти в Google Cloud, Manage resources. Можно это сделать по ссылке https://console.cloud.google.com/cloud-resource-manager
Третье нажимаем по кнопке CREATE PROJECT
Четвертое вводим произвольное название проекта и нажимаем "Create"
Теперь нужно подождать, обычно проект создается в течение 1 минуты, но время может быть разным. Как только проект появится в списке, это значит он был создан.
Далее нажимаем на уведомления в правом верхнем углу и там выбираем "Select Project"
Иногда при нажатии "Select Project" ничего не происходит, в этом случае нажмите по всему уведомлению вокруг кнопки.
Также, после создания проекта в его настройки вы можете перейти по ссылке https://console.cloud.google.com/home/dashboard
Там в левом углу вы сможете выбрать ваш проект.
Пятое нам понадобится настроить пункт "Explore and enable APIs"
Заходим в пункт "Explore and enable APIs".
Далее нажимаем "+ Enable APIs and services".
Нам нужен пункт "Google Sheets API"
Его можно найти в разделе Google Workspace.
Или вы можете воспользоваться поиском по странице в браузере нажам CTRL+F и вбить в поиск "Google Sheets"
Также, наверху страницы есть поиск по сервисам, через него вы сможете найти.
Выбираем "Google Sheets API"
Включаем "Google Sheets API" нажав по кнопке "Enable"
После включения переходим в раздел "Credentials". Перейти в него можно из меню слева.
Далее справа внизу будет кнопка "Manage service accounts"
Нажимаем по кнопке "Manage service accounts"
Следующим шагом нужно нажать по кнопке "+ Create service account"
Заполните поля:
- Service account name - можете задать название для себя, в нашем примере мы указали BB test
- Service account ID - это название будет использоваться в сервисном емайл адресе. В нашем случае мы заполнили "bbtest" и получили сервисный Email "bbtest@bb-test-2-428610.iam.gserviceaccount.com". Он нам понадобится в будущем.
Нажмите по кнопке "Create and continue"
Далее нажмите кнопку "Done"
Скопируйте ваш сервисный емайл адрес и сохраните его куда-нибудь, он нам понадобится в будущем.
На этой же странице в разделе "Action" нажимаем 3 точки и выбираем "Manage keys"
Нажимаем "Add key" и "Create new key"
Выбираем "JSON" и нажимаем "Create"
У вас скачается файл с содержимым, оно нам понадобится далее. Если вы потеряете этот файл, в будущем вы можете создать новый ключ.
Все основная работа создана, теперь вы можете использовать сервисный емайл и содержимое файла json для дальнейшей настройки.
Добавим сервисный емайл в нужные нам Google Таблицы
Теперь нам нужно понять с какой таблицей будем взаимодействовать, для примера мы создадим новую.
Для этого перейдем по ссылке https://docs.google.com/spreadsheets/
И там нажмем по "Пустая страница". Но вы можете делать дальнейшие манипуляции с любой другой Google Таблицей.
После того как вы зашли в нужную вам Google Таблицу, вам нужно выдать доступ на наш сервисный емайл
После того, как Google Таблица была создана необходимо предоставить доступ нашему сервисному аккаунту на её редактирование. Для этого нажимаем кнопку Настройки Доступа в верхнем правом углу.
Указываем там почту сервисного аккаунта.
В нашем примере это "bbtest@bb-test-2-428610.iam.gserviceaccount.com", что мы говорили нужно сохранить для дальнейшего использования. Если вы не сохранили данный емайл, то вы всегда сможете его снова скопировать перейдя на страницу https://console.cloud.google.com/iam-admin/serviceaccounts и дальше выбрав ваш проект.
После ввода сервисного аккаунта, оставляем права "Редактор", убираем галочку с "Уведомить пользователей" и нажимаем "Открыть доступ"
Все теперь сервисный аккаунт нам не понадобится, но в будущем его можно будет просто добавлять в нужные таблицы для создания интеграций с Botbrother.ru
На данном шаге нам нужно записать идентификатор таблицы ($spreadsheetId), его можно взять в адресной строке таблицы.
На скриншоте мы выделили где находится этот идентификатор (между d/ и /edit). Копируем идентификатор, в нашем примере это 11PowRoAUpymitGjrYI-5qKtaa4J_EEfapzwA22JntVs
Запишите его куда-то он нам понадобится далее.
Теперь мы создали сервисный аккаунт, дали ему доступ к нужным нам таблицам и записали идентификатор таблиц.
Добавляем Google Таблицы в Botbrother.ru
Далее переходим в https://botbrother.ru/, авторизируемся и выбираем нужного нам бота.
Переходим в раздел "Дополнения" и в "Google Таблицы". Нажимаем "+ Добавить новый доступ"
Заполняем данные:
- Название доступа к таблице - задаем удобное для вас название
- Содержимое json доступа - берем его из файла, что мы скачали на предыдущем этапе json. Открыть его можно через блокнот или браузер. После открытия скопируйте все содержимое и вставьте в поле "Содержимое json доступа"
- Идентификатор документа - сюда добавляем идентификатор нашей таблицы, в нашем примере это 11PowRoAUpymitGjrYI-5qKtaa4J_EEfapzwA22JntVs
Все! Вы прошли все шаги и теперь сможете создать действия связанные с наполнением таблицы или получения данных из таблицы.
Для этого нам понадобится создать нужные переменные данные, создать "Связки столбцов таблицы с переменными данными" и добавим действия в ваш бот.
Об этом мы поговорим в следующих наших обучающих материалах.
Важное дополнение, данный json доступ и сервисный аккаунт вы можете создать один раз и использовать во всех ваших интеграциях и ботах, поэтому данный путь можно пройти один раз и далее гораздо проще подключать данную интеграцию.
Подписывайтесь на обновления, впереди много интересных материалов.
