🧭 Інструкція: Як підготувати Google API доступ для Telegram-бота

Ця покрокова інструкція допоможе створити новий проєкт у Google Cloud, увімкнути потрібні API, згенерувати ключ сервісного акаунта та підготувати дані таблиці Google Sheets для роботи бота.

⏱ Орієнтовний час: 10 хвилин. Потрібен лише веббраузер.

1Увійди до Google Cloud Console

  1. Перейди за посиланням: https://console.cloud.google.com/
  2. Увійди під своїм Google-акаунтом (адреса Gmail).
Екран входу до Google Cloud Console
Вікно входу до Google Cloud Console.

2Створи новий проєкт

  1. У верхній панелі натисни кнопку Select project.
  2. У модальному вікні натисни New Project.
  3. У полі Project name введи, наприклад, telegram-bot-api.
  4. Натисни Create, а після створення — Select Project, щоб перейти в нього.
Створення нового проєкту
Вікно створення проєкту — обери назву telegram-bot-api.

3Увімкни необхідні API

API потрібні, щоб бот міг записувати дані в таблицю та експортувати PDF через Google Drive.

  1. Відкрий Google Sheets API і натисни Enable.
  2. Відкрий Google Drive API і натисни Enable.
  3. Дочекайся 1–2 хвилини, поки обидва сервіси активуються.
Увімкнення Google Sheets API
Сторінка активації Google Sheets API — натисни Enable.
Увімкнення Google Drive API
Сторінка активації Google Drive API.

4Створи сервісний акаунт

  1. Перейди до розділу Service Accounts.
  2. Натисни Create Service Account.
  3. У полі Service account name введи telegram-bot.
  4. Натисни Create and continue.
  5. На кроці Grant this service account access to the project натисни Select a role.
  6. У списку ролей обери Basic → Editor.
  7. Натисни Continue, потім Done, щоб завершити створення.
Список сервісних акаунтів
Розділ створення сервісного акаунта.
Форма створення сервісного акаунта
Форма створення — вкажи ім’я telegram-bot, обери роль Editor та заверш створення.

5Згенеруй ключ (JSON)

  1. У списку акаунтів натисни на створений telegram-bot@….
  2. Відкрий вкладку Keys.
  3. Натисни Add key → Create new key.
  4. Обери JSON і натисни Create.
  5. Збережи завантажений файл — це і є ключ для бота.
Вкладка Keys сервісного акаунта
Перейди на вкладку Keys та додай новий ключ.
Створення JSON-ключа
Створи ключ у форматі JSON і збережи файл.

6Підготуй дані Google Sheets

Боту потрібні дані з таблиці, щоб підставляти суму в потрібну комірку та експортувати PDF.

  1. Відкрий потрібну таблицю в Google Sheets.
  2. Скопіюй Spreadsheet ID — це довга частина в адресному рядку між /d/ та /edit.
  3. Переконайся, що потрібний лист має назву Лист1 (або запиши фактичну назву для змінної SHEET_NAME).
  4. Визнач комірку, куди бот має записувати суму (наприклад, C25 для змінної SUM_CELL).
Пошук Spreadsheet ID
У браузері виділено Spreadsheet ID.
Перейменування листа
Переконайся, що лист називається Лист1 або запам’ятай свою назву.
Комірка для введення суми
Визнач комірку (наприклад, C25), куди бот записуватиме суму.

7Надай доступ сервісному акаунту

  1. У таблиці натисни Share (Поділитися).
  2. У поле введи адресу сервісного акаунта (наприклад, telegram-bot@telegram-bot-api.iam.gserviceaccount.com).
  3. Вибери роль Editor і натисни Done.
  4. Якщо PDF створюється з окремого файла на Google Drive — надай йому такий самий доступ.
Надання доступу сервісному акаунту
Додай сервісний акаунт у співавтори з правами Editor.

8Передай ключ і змінні для бота

Після завершення попередніх кроків у тебе є:

Ці значення потрібно передати розробнику або додати в файл .env бота:

GOOGLE_SERVICE_ACCOUNT_FILE=telegram-bot-123abc456def.json SPREADSHEET_ID=1AbCdEfGhIjKlMnOpQrStUvWxYz1234567890 SHEET_NAME=Лист1 SUM_CELL=C25

Не змінюй вміст JSON-файла та зберігай його в безпечному місці. Передавай ключ лише довіреним людям.

9Підсумок

Все готово для передачі ключа та параметрів розробнику, щоб Telegram-бот міг працювати з вашою таблицею.