Google Ads API CLI: przygotowanie infrastruktury.

Zaprojektowałem i przygotowałem lokalną usługę CLI na Node.js + TypeScript do pozyskiwania statystyk reklamowych z Google Ads API oraz dalszej generacji raportów gotowych do AI.

Projekt został doprowadzony do etapu pełnej gotowości technicznej: stworzono szkielet CLI, skonfigurowano Google Cloud, OAuth, MCC, Developer Token, refresh token oraz połączenie z kontem reklamowym. Weryfikacja API pomyślnie dotarła do ostatecznego ograniczenia systemowego Google: oczekiwanie na zatwierdzenie Basic Access do pracy z rzeczywistymi kontami reklamowymi.

1. Stworzono oddzielny projekt CLI Google Ads API

Utworzono oddzielny folder roboczy:

F:\GOOGLE_ADS_API_Stats

Projekt nie został pomieszany z Meta Ads CLI, aby nie uszkodzić już działającego systemu Meta. Wewnątrz przygotowano podstawowe pliki projektu: package.json, tsconfig.json, .env.example, .gitignore, README.md, PROJECT_CONTEXT.md, project_config.json, a także strukturę src/ z CLI, konfiguracją, klientem Google Ads, usługami i narzędziami.

2. Zbudowano szkielet TypeScript CLI

Zrealizowano podstawowe komendy:

doctor
doctor --ping
customers / accounts
campaigns
report

Komenda report już tworzy szkielet raportu Markdown w folderze reports/, bez tokenów i sekretów.

3. Podłączono bibliotekę Google Ads API

Do projektu dodano zależność:

google-ads-api ^23.0.0

Przygotowano klienta tylko do odczytu dla przyszłych zapytań GAQL, normalizacja customer_id, login_customer_id, obsługa błędów Google Ads API oraz ochrona przed zapytaniami write/mutate.

4. Skonfigurowano konto menedżera Google Ads / MCC

Utworzono konto zarządzające:

Me4Hik Google Ads Manager

Jest potrzebne dla modelu agencji: konto reklamowe klienta pozostaje u właściciela biznesu, a zarządzanie i dostęp do API odbywa się przez MCC.

5. Uzyskano Developer Token

W Google Ads API Center utworzono Developer Token. Na obecnym etapie ma status Test Account Access, dlatego dla rzeczywistych kont złożono wniosek o Basic Access.

6. Złożono wniosek o Google Ads API Basic Access

Przygotowano i dołączono dokument projektowy dla zespołu zgodności Google Ads API. W dokumencie opisano, że narzędzie działa jako lokalny CLI tylko do odczytu dla raportowania i analizy, nie tworzy ani nie zmienia kampanii, ogłoszeń, stawek, budżetów ani słów kluczowych.

7. Skonfigurowano projekt Google Cloud

Utworzono oddzielny projekt Google Cloud:

Google Ads API CLI

W nim włączono Google Ads API i skonfigurowano Google Auth Platform.

8. Skonfigurowano OAuth

Utworzono klienta OAuth, skonfigurowano OAuth Playground, uzyskano refresh token, wypełniono wszystkie kluczowe pola .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. Sprawdzono cały łańcuch dostępu

Komenda doctor --ping dotarła do Google Ads API. Błędy OAuth, redirect URI, client secret, refresh token, połączenie MCC i customer ID zostały kolejno usunięte.

Ostateczna weryfikacja napotkała tylko oczekiwany blokujący problem systemowy:

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

To znaczy, że infrastruktura jest gotowa, ale Google musi zatwierdzić Basic Access.

Praktyczna wartość

Ten etap jest ważny, ponieważ Google Ads API to nie tylko „uzyskać token”. Należy połączyć ze sobą:

Google Ads MCC
Developer Token
Google Cloud Project
OAuth Client
Refresh Token
Customer ID
Login Customer ID
lokalny CLI
bezpieczne przechowywanie sekretów

Po zatwierdzeniu Basic Access usługę można rozwijać dalej: pozyskiwać kampanie, wydatki, kliknięcia, konwersje, zapytania, urządzenia, geografię i tworzyć pełnoprawne raporty gotowe do AI do analizy w ChatGPT.

#GoogleAdsAPI #GoogleAds #PPC #PerformanceMarketing #MarketingAutomation #NodeJS #TypeScript #CLI #OAuth2 #GoogleCloud #GAQL #AdsAnalytics #AIAnalytics #ChatGPT #ReklamowaAnaliza #AutomatyzacjaRaportów #ReklamaKontekstowa