Google Ads

Potrzebujesz 6 zmiennych (4 obowiązkowe + 2 opcjonalne). Oto ich lista, zanim zaczniesz , wpisz każdą w Railway (projekt operlance-staging → usługa api → Variables, sekcja E) w chwili, gdy ją zdobędziesz, kroki niżej mówią dokładnie kiedy:

Wszystkie sześć trafiają w to samo miejsce: Railway → projekt operlance-staging → usługa api → zakładka Variables. Nigdy nigdzie indziej.

Uwaga (Google, 9 września 2026): tokeny dewelopera Google Ads zostały wycofane, GOOGLE_ADS_DEVELOPER_TOKEN NIE jest już potrzebny (Operlance go nie wysyła). Poziom dostępu do API jest teraz przypisany do projektu Google Cloud z C1, nie do tokena ani do konta menedżerskiego (MCC), a konto MCC nie jest już wymagane do niczego w tym procesie.

C1. Projekt Google Cloud (5 min, bez zmiennej do zapisania)

1. https://console.cloud.google.com → menu projektów (góra) → New project → nazwa Operlance → Create → wybierz projekt.
2. APIs & Services → Library → wyszukaj Google Ads API → Enable.

C2. OAuth consent screen (10 min, bez zmiennej do zapisania; weryfikacja Google tylko przy publikacji)

1. APIs & Services → OAuth consent screen (nowy widok: Google Auth Platform → Branding).
2. User type: External → Create. App name Operlance, support e-mail = Twój, developer contact = Twój.
3. Scopes → Add or remove scopes → wpisz ręcznie https://www.googleapis.com/auth/adwords → Update → Save and continue.
4. Test users → + Add users → Twój adres Google, którym logujesz się do Google Ads → Save.
5. Zostaw Publishing status: Testing. W tym trybie refresh token wygasa po 7 dniach: na start wystarczy; przed produkcją klikniesz Publish app (bez weryfikacji Google działa, bo scope adwords nie jest „sensitive” w rozumieniu przeglądu: ekran ostrzeżenia „unverified app” widzisz tylko Ty).

C3. OAuth client (3 min; stan 2026-09-19: klient i redirect URI https://api.operlance.app/v1/integrations/google_ads/callback już dodane, poniżej opis pierwotny)

1. APIs & Services → Credentials → + Create credentials → OAuth client ID.
2. Application type: Web application, nazwa Operlance api.
3. Authorized redirect URIs → + Add URI: https://api.operlance.app/v1/integrations/google_ads/callback oraz (na czas generowania tokena narzędziem) http://localhost:8080.
4. Create → zobaczysz dwie wartości:
5. Client ID → Railway (operlance-staging → api → Variables): zmienna GOOGLE_ADS_CLIENT_ID.
6. Client secret → Railway (to samo miejsce): zmienna GOOGLE_ADS_CLIENT_SECRET.

C4. Numer konta i poziom dostępu Google Ads (10 min + ewentualna weryfikacja)

1. https://ads.google.com → zaloguj się kontem z C2 pkt 4 → numer konta THARAN w prawym górnym rogu ekranu (10 cyfr, z myślnikami albo bez, obojętne) → Railway (operlance-staging → api → Variables): zmienna GOOGLE_ADS_CUSTOMER_ID.
2. Poziom dostępu do API (Test/Explorer/Basic) jest przypisany do projektu Google Cloud z C1, ustawiasz go w Cloud Console, nie na koncie menedżerskim: a. Wejdź na https://console.cloud.google.com → wybierz projekt użyty w C1 → Google Ads API Overview. b. Sekcja "Upgrade access level" pokaże Twój aktualny poziom (Test). c. Request access → Explorer: zwykle zatwierdzane automatycznie, od razu. d. Request access → Basic: najpierw wymaga Brand Verification projektu w Cloud Console (nowy wymóg Google), wypełnij tam nazwę firmy i URL (https://operlance.app), potem dopiero wniosek o Basic. Google po kliknięciu Request access dla Basic może przekierować na wspólny formularz supportu "App Conversion Tracking & Remarketing API" z mylącym banerem u góry (to nie jest błąd, Google używa go też do wniosków Basic Access dla Google Ads API). Mimo mylącego nagłówka wypełnij go: w polu 7 (business model) napisz wprost, że to wniosek o standardowy dostęp do Google Ads API (reporting), nie app conversion tracking, żeby recenzent Google poprawnie to zakwalifikował. Pole 11 (link do aplikacji) nie jest dla nas relewantne, jako obejście można wpisać https://operlance.app. Czas weryfikacji Basic: zwykle 1 do 3 dni robocze, bywa do 2 tygodni. Do tego czasu robimy sync na koncie testowym. Ten krok nie daje nowej zmiennej, to tylko wniosek, czekasz na decyzję/e-mail od Google.
3. Opcjonalnie, tylko jeśli zarządzasz kontem THARAN przez konto menedżerskie (MCC): numer konta MCC (10 cyfr) → Railway: zmienna GOOGLE_ADS_LOGIN_CUSTOMER_ID. Jeśli nie masz MCC, pomiń ten krok, nic nie tracisz.

C5. Refresh token (5 min; jednorazowo, na Twoim komputerze) Skrypt jest w repo: packages/integrations/scripts/google-refresh-token.mjs (Node 22, bez zależności, nic nie zapisuje na dysk).

1. W C3 dodaj redirect URI http://127.0.0.1:8085/callback (dokładnie tak, z portem).
2. W terminalu, w katalogu repo: node packages/integrations/scripts/google-refresh-token.mjs. Skrypt zapyta o Client ID i Client secret z C3 (secret wpisujesz na ślepo), otworzy przeglądarkę: zaloguj się kontem z C2 pkt 4 i zatwierdź dostęp.
3. Skrypt wypisze GOOGLE_ADS_REFRESH_TOKEN=... → skopiuj samą wartość (bez GOOGLE_ADS_REFRESH_TOKEN=) do Railway (operlance-staging → api → Variables): zmienna GOOGLE_ADS_REFRESH_TOKEN. Potem wyczyść terminal (clear). Nie wysyłaj tokena nam. Jeśli skrypt zgłosi brak refresh tokena: cofnij dostęp na https://myaccount.google.com/permissions i uruchom ponownie.

Alternatywa bez skryptu: narzędzie Google OAuth 2.0 Playground (https://developers.google.com/oauthplayground → ⚙ „Use your own OAuth credentials” → wpisz Client ID/Secret z C3 → scope https://www.googleapis.com/auth/adwords → Authorize → Exchange → skopiuj Refresh token → ta sama zmienna GOOGLE_ADS_REFRESH_TOKEN); wtedy w C3 dodaj redirect URI https://developers.google.com/oauthplayground.

C6. Relay webhooków (opcjonalnie, na później, można pominąć teraz): wygeneruj losowy ciąg ≥ 32 znaki (np. w 1Password: Generate Password) → Railway (operlance-staging → api → Variables): zmienna GOOGLE_ADS_RELAY_SECRET. Google Ads nie ma webhooków; bez tej zmiennej wszystko i tak działa przez codzienny sync.

To wszystkie zmienne sekcji C. Jeśli w Railway masz już wszystkie obowiązkowe z tabeli na górze (poza opcjonalnymi, jeśli ją pomijasz), sekcja Google Ads jest gotowa , napisz Mózgowi „sekcja C gotowa”.

---