Налаштування проєкту в Google Cloud Console

Google Cloud Console (або просто GCP Console) — це веб-платформа для керування всіма вашими проєктами і сервісами в екосистемі Google Cloud. Вона дозволяє тобі буквально "налаштувати і забути" все, що стосується доступу до API сервісів Google. Наприклад, додавання ключів API, налаштування ролей і дозволів, а також керування сервісними акаунтами.

Чому це важливо? Уяви, що треба регулярно оновлювати звіти в Google Sheets або завантажувати файли в Google Drive. Без GCP Console довелося б ламати голову, як правильно налаштувати доступ, токени і підтвердження. З GCP Console усе це стає значно простіше.

---

Створення проєкту в Google Cloud Console

Крок 1. Заходимо в Google Cloud Console

Спершу потрібно перейти в Google Cloud Console: https://console.cloud.google.com. Якщо ти ще не авторизувався, попросить ввійти в твій Google акаунт.

Крок 2. Створюємо новий проєкт

1. У верхній навігаційній панелі натискаємо на випадаючий список "Проєкт" і вибираємо "Створити проєкт".
2. Вводимо назву проєкту. Наприклад, My FastAPI Integration Project.
3. Вказуємо "Організацію" (якщо це потрібно) або залишаємося зі значенням за замовчуванням.
4. Натискаємо "Створити".

Крок 3. Активуємо API для проєкту

Більшість сервісів (наприклад, Google Sheets або Google Drive) за замовчуванням вимкнені. Їх потрібно вручну активувати:

1. Перейдіть в меню "API і сервіси" → "Бібліотека".
2. В рядку пошуку введіть цікавий вам API (наприклад, "Google Sheets API").
3. Натисніть на знайдений API і оберіть "Увімкнути".

Повторіть цю операцію для всіх потрібних вам сервісів, таких як:

• Google Sheets API,
• Google Drive API,
• Google Maps API (якщо плануєте працювати з картами).

---

Налаштування платіжних методів

Google любить гроші, а ми любимо працюючий API. Тому потрібно додати метод оплати, щоб мати доступ до всіх сервісів.

1. Перейдіть в меню "Оплата та виставлення рахунків" → "Налаштування платежів".
2. Додайте свою кредитну/дебетову картку.

---

Керування правами доступу (IAM)

IAM (Identity and Access Management) дозволяє налаштувати доступ до твого проєкту. Наприклад, якщо працюєш у команді, можна призначити ролі, щоб няня твого котика випадково не видалила проєкт.

Налаштування ролей і дозволів:

1. Перейдіть в "IAM та адміністратор" → "IAM".
2. Натисніть "Додати".
3. Вкажіть Google акаунт, який отримає доступ.
4. Призначте роль, наприклад:
   • Viewer: для тих, хто просто дивиться (і нічого не ламає).
   • Editor: для тих, кому довіряєш трохи більше.
   • Owner: для тебе, короля/королеви свого проєкту.

Налаштування сервісних акаунтів

Якщо твій проєкт — це автоматизований процес (наприклад, скрипт, який синхронізує дані), йому теж потрібен доступ до Google API. Тут на допомогу приходять сервісні акаунти. Це як акаунти користувачів, тільки роботизовані.

Створити сервісний акаунт можна наступним чином:

1. Перейдіть в "IAM та адміністратор" → "Сервісні акаунти".
2. Натисніть "Створити сервісний акаунт".
3. Введіть назву (наприклад, FastAPI Bot Account) і опис.
4. Призначте ролі для сервісного акаунта:
   • Для роботи з Google Sheets: Editor або Owner.
   • Для Google Drive: Drive Admin.
   • Для Google Maps: Maps Viewer.
5. Натисніть "Готово".

Щоб згенерувати ключ для сервісного акаунта:

1. В списку сервісних акаунтів виберіть створений акаунт.
2. Натисніть "Створити ключ".
3. Оберіть формат JSON та завантажте файл.

Цей JSON-файл знадобиться для роботи з Google API через будь-який додаток, включно з FastAPI. У ньому містяться всі необхідні дані для аутентифікації.

---

Перевіримо налаштування проєкту

Тепер, коли проєкт створено, сервісні акаунти налаштовані, і ключі готові, переконаємося, що все працює.

Переконайся, що у тебе встановлене та активне віртуальне оточення для Python (наприклад, за допомогою venv).

pip install google-auth google-auth-oauthlib google-auth-httplib2

Приклад підключення до сервісного акаунта:

Створи файл connect_to_gcp.py:

from google.oauth2 import service_account

# Шлях до вашого JSON-файлу з ключами сервісного акаунта
SERVICE_ACCOUNT_FILE = 'path_to_your_service_account.json'

# Список дозволів (в даному випадку для Google Drive)
SCOPES = ['https://www.googleapis.com/auth/drive']

# Підключення до сервісного акаунта
credentials = service_account.Credentials.from_service_account_file(
    SERVICE_ACCOUNT_FILE, scopes=SCOPES
)

print("Успішне підключення!")

Запусти код. Якщо все налаштовано правильно, ти побачиш повідомлення "Успішне підключення!". Тепер твій додаток готовий до взаємодії з API!

---

Корисні ресурси

Для подальших кроків ознайомся з офіційною документацією Google:

• Документація Google Cloud Console
• API та сервіси

Тепер, коли ти налаштував проєкт у Google Cloud Console, можна переходити до наступної теми — аутентифікації через OAuth2 і роботи з конкретними API! 🚀