Google Ads API CLI: підготовка інфраструктури.

Спроектував і підготував локальний CLI-сервіс на Node.js + TypeScript для отримання рекламної статистики з Google Ads API та подальшої генерації AI-ready звітів.

Проект доведений до стадії повної технічної готовності: створено CLI-скелет, налаштовані Google Cloud, OAuth, MCC, Developer Token, refresh token та зв'язка з рекламним акаунтом. API-перевірка успішно дійшла до фінального системного обмеження Google: очікування схвалення Basic Access для роботи з реальними рекламними акаунтами.

1. Створено окремий Google Ads API CLI-проект

Створена окрема робоча папка:

F:\GOOGLE_ADS_API_Stats

Проект не змішувався з Meta Ads CLI, щоб не ламати вже працюючу систему по Meta. Всередині підготовлені основні файли проекту: package.json, tsconfig.json, .env.example, .gitignore, README.md, PROJECT_CONTEXT.md, project_config.json, а також структура src/ з CLI, конфігом, Google Ads клієнтом, сервісами та утилітами.

2. Зібрано TypeScript CLI-скелет

Реалізовані базові команди:

doctor
doctor --ping
customers / accounts
campaigns
report

Команда report вже створює skeleton Markdown-звіт у папці reports/, без токенів і секретів.

3. Підключена бібліотека Google Ads API

В проект додана залежність:

google-ads-api ^23.0.0

Підготовлений read-only клієнт для майбутніх GAQL-запитів, нормалізація customer_id, login_customer_id, обробка помилок Google Ads API та захист від write/mutate-запитів.

4. Налаштований Google Ads Manager Account / MCC

Створено управляючий акаунт:

Me4Hik Google Ads Manager

Він потрібен для агентської моделі: клієнтський рекламний акаунт залишається у власника бізнесу, а управління та API-доступ йдуть через MCC.

5. Отримано Developer Token

В Google Ads API Center створено Developer Token. На поточному етапі він має статус Test Account Access, тому для реальних акаунтів була подана заявка на Basic Access.

6. Подана заявка Google Ads API Basic Access

Підготовлений і доданий design document для Google Ads API Compliance Team. У документі описано, що інструмент працює як локальний read-only CLI для звітності та аналітики, не створює і не змінює кампанії, оголошення, ставки, бюджети або ключові слова.

7. Налаштований Google Cloud Project

Створено окремий Google Cloud Project:

Google Ads API CLI

В ньому включено Google Ads API та налаштовано Google Auth Platform.

8. Налаштований OAuth

Створено OAuth Client, налаштовано OAuth Playground, отримано refresh token, заповнені всі ключові .env-поля:

GOOGLE_ADS_DEVELOPER_TOKEN
GOOGLE_ADS_CLIENT_ID
GOOGLE_ADS_CLIENT_SECRET
GOOGLE_ADS_REFRESH_TOKEN
GOOGLE_ADS_CUSTOMER_ID
GOOGLE_ADS_LOGIN_CUSTOMER_ID
GOOGLE_ADS_API_VERSION
9. Перевірена вся ланцюг доступу

Команда doctor --ping дійшла до Google Ads API. Помилки OAuth, redirect URI, client secret, refresh token, MCC-зв'язки та customer ID були послідовно усунені.

Фінальна перевірка вперлася тільки в очікуваний системний блокер:

The developer token is only approved for use with test accounts.

Тобто інфраструктура готова, але Google має схвалити Basic Access.

Практична цінність

Цей етап важливий, тому що Google Ads API — це не просто “отримати токен”. Потрібно зв'язати між собою:

Google Ads MCC
Developer Token
Google Cloud Project
OAuth Client
Refresh Token
Customer ID
Login Customer ID
локальний CLI
безпечне зберігання секретів

Після схвалення Basic Access сервіс можна розвивати далі: отримувати кампанії, витрати, кліки, конверсії, пошукові запити, пристрої, географію та формувати повноцінні AI-ready звіти для аналізу в ChatGPT.

#GoogleAdsAPI #GoogleAds #PPC #PerformanceMarketing #MarketingAutomation #NodeJS #TypeScript #CLI #OAuth2 #GoogleCloud #GAQL #AdsAnalytics #AIAnalytics #ChatGPT #РекламнаАналитика #АвтоматизаціяЗвітів #КонтекстнаРеклама