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 client, сервисами и утилитами.

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 #РекламнаяАналитика #АвтоматизацияОтчетов #КонтекстнаяРеклама