Ukratko
Jedan Google Cloud projekat pokriva Google Ads, GA4, Search Console, Tag Manager, Merchant Center i Data Manager API - ne trebaju vam odvojene aplikacije za svaki alat. Najveća greška koju sam video (i sam napravio): OAuth consent screen ostaje u Testing modu, pa refresh token prestane da radi tačno posle 7 dana.
1
Cloud projekat za sve API-je
7 dana
Rok pre nego što Testing token umre
6
API-ja u ovom vodiču
0 €
Cena Cloud projekta i pristupa
Brzi odgovor
Koje Google API pristupe treba da ima PPC agencija?
Agencija koja vodi više naloga treba pristup za šest servisa: Google Ads API (reporting i upravljanje kampanjama), GA4 Data i Admin API (izveštaji i podešavanja naloga), Search Console API (pretraga i indeksiranje), Tag Manager API (audit i izmena tagova), Merchant Center API (feed status i product issues) i noviji Data Manager API (server-side slanje audience podataka). Svih šest se autentifikuje preko istog Google Cloud projekta - kreirate ga jednom, uključite API-je koji vam trebaju, i generišete OAuth kredencijale za svaki.
Kad sam prošao kroz aplikaciju za Google Ads API Basic Access, ispostavilo se da je developer token samo jedan deo slagalice. Ista agencija koja automatizuje reporting za Google Ads treba i GA4 podatke za attribution, Search Console podatke za SEO stranu, Tag Manager za tracking audit, i Merchant Center za Shopping feed dijagnostiku. Svaki od tih alata ima svoj API, svoj scope i svoja pravila, ali svi žive pod jednim krovom: Google Cloud projekat koji jednom podesite i onda samo dodajete servise.
Ovaj vodič pokriva ceo taj krov, od nule. Prolazimo kroz temelj (Cloud projekat i OAuth consent screen, uključujući grešku koja mi je jednom ugasila token), pa kroz svaki od šest API-ja pojedinačno, sa scope-om koji vam treba i mestom gde se uključuje. Za Google Ads API developer token i brand verification pilot postoji poseban, detaljan vodič na koji ću linkovati u odgovarajućoj sekciji - ovde ga samo smeštam u širi kontekst.
Zašto agenciji trebaju API pristupi
Dok se nalozi broje na prste jedne ruke, interfejs je sasvim dovoljan. Otvorite Google Ads, pogledate performanse, otvorite GA4, uporedite brojke, gotovo. Problem nastaje kad broj naloga pređe desetak, a vreme koje imate na raspolaganju ostaje isto. Ručno otvaranje svakog naloga svako jutro nije održivo, i tu API pristup prestaje da bude "nice to have" i postaje jedini realan način da posao stane u dan.
Konkretno, API pristup omogućava četiri stvari koje interfejs ne radi sam od sebe: automatizovani reporting koji se generiše bez da ga vi pokrećete, dashboarde koji povlače podatke sa više naloga na jedno mesto, bulk operacije (izmena budžeta na deset naloga odjednom, na primer) i, sve više, agentsku automatizaciju gde AI agent čita podatke preko API-ja i predlaže ili sprovodi akcije po unapred definisanim pravilima.
Sve to zahteva da vaša agencija ima programski pristup podacima, ne samo pristup preko browsera. I tu dolazimo do prvog, i verovatno najvažnijeg uvida: ne treba vam posebna "aplikacija" za svaki alat.
Jedan Google Cloud projekat je vaša jedina "aplikacija" prema Google-u. U njemu uključite Google Ads API, GA4 API, Search Console API, Tag Manager API i ostale - svaki dodatni API je samo klik na "Enable" u istom projektu, ne novi projekat i ne nova registracija.
Temelj: Cloud projekat i OAuth consent screen
Pre nego što dotaknete bilo koji pojedinačni API, postoje dve stvari koje morate podesiti jednom, na nivou celog projekta. Prva je sam Google Cloud projekat - besplatan, kreira se za par minuta preko Google Cloud Console-a, i služi kao kontejner u koji ćete kasnije uključivati API-je. Druga, i mnogo važnija za dugoročnu stabilnost, jeste OAuth consent screen.
OAuth consent screen je ekran koji korisnik vidi kada vaša aplikacija (odnosno vi, kao developer) traži dozvolu da pristupi njegovim Google podacima - Ads nalogu, GA4 property-ju, Search Console-u. Svaki OAuth flow prolazi kroz njega, bez obzira na to koji od šest API-ja iz ovog vodiča koristite. I upravo tu se krije greška koja izgleda bezazleno dok vas ne udari.
Ključna lekcija
Ako OAuth consent screen ostane u statusu Testing, refresh token koji dobijete ističe posle 7 dana, bez obzira na to koliko dobro sve ostalo radi. Svaka skripta koja se oslanja na taj token prestaje da radi tačno nedelju dana kasnije, obično bez jasne poruke o tome zašto. Meni se to desilo baš na jednom Merchant Center tokenu - projekat je ostao u Testing modu, sve je radilo savršeno prvih nekoliko dana, i onda je refresh naprosto prestao. Rešenje je jednostavno, ali ga morate uraditi svesno: u Cloud Console-u, pod OAuth consent screen, odnosno Google Auth Platform → Audience, prebacite publishing status sa Testing na In production.
Prebacivanje u Production ne znači da vam aplikacija mora biti javna ili da je neko spolja pregleda pre nego što proradi - za interne alate sa ograničenim brojem scope-ova, ovo je uglavnom samoposlužni proces bez dodatnog čekanja. Google zahteva verifikaciju sa ljudske strane samo kod određenih "sensitive" ili "restricted" scope-ova (na primer širi pristup Gmail-u), a za ono što agencija tipično koristi - Ads, Analytics, Search Console, Tag Manager, Merchant Center - status In production možete postaviti sami, odmah.
Iz mog iskustva
Prvi put kada podešavate Cloud projekat, uradite ovaj korak odmah, pre nego što uopšte generišete prvi OAuth kredencijal. Testing mod ima smisla samo dok doslovno testirate autentifikaciju u prvih par sati - čim planirate da skripta radi duže od nedelju dana, status mora biti Production. Ovo je jeftin korak da propustite jednom, a skup da otkrivate kroz mrtvu automatizaciju.
Google Ads API
Google Ads API je verovatno prvi API po koji agencija poseže, jer direktno diže reporting i upravljanje kampanjama na nivo koji ručni rad ne može da isprati. Pristup se drži na nivou manager (MCC) naloga preko developer tokena, i taj token prolazi kroz tri nivoa: Explorer access (default, do 2.880 operacija dnevno na produkcijskim nalozima), Basic Access (do 15.000 operacija dnevno plus planning servisi) i Standard Access (bez dnevnog limita, za alate velikog obima).
Explorer nivo je dovoljan da povlačite izveštaje i radite osnovne izmene na svojim nalozima, ali sa dva ograničenja koja se brzo osete: dnevni limit od 2.880 operacija i potpuno blokirani planning servisi. Pozivi ka Keyword Planner delu API-ja, za generisanje ideja za ključne reči ili procenu volumena pretrage, vraćaju grešku DEVELOPER_TOKEN_NOT_APPROVED sve dok ne dobijete Basic Access. To je i glavni praktični razlog da aplikaciju pošaljete pre nego što vam limiti stvarno zasmetaju.
Detaljan vodič
Ceo proces aplikacije za Basic Access, uključujući noviji brand verification pilot koji ubrzava review sa dana ili nedelja na par sati, pokriven je korak po korak u odvojenom vodiču: Google Ads API Basic Access - vodič korak po korak. Ovde samo napominjem da OAuth scope koji vam treba je https://www.googleapis.com/auth/adwords, i da se sve dešava u istom Cloud projektu koji ste podesili u prethodnoj sekciji.
Google Analytics 4: Data i Admin API
GA4 nudi dva odvojena API-ja koja rade različite stvari. Data API je onaj koji zovete za same izveštaje - metrike i dimenzije, praktično sve što vidite u GA4 interfejsu pod Reports, samo programski. Admin API upravlja strukturom naloga: property-jima, streams-ovima, custom dimenzijama i merama, korisničkim pristupima. Za tipičan dashboard ili noćni izveštaj, Data API je ono što zapravo koristite; Admin API vam zatreba kad automatizujete sam setup naloga, ne izvlačenje podataka iz njega.
Oba API-ja se uključuju iz istog mesta: Cloud Console → APIs & Services → Library, pretraga "Google Analytics Data API" i "Google Analytics Admin API", pa Enable na svakom. Za čisto čitanje podataka (što je 95% agencijske upotrebe), scope https://www.googleapis.com/auth/analytics.readonly je sve što vam treba. Ako planirate i pisanje - kreiranje custom dimenzija preko API-ja, na primer - potreban vam je širi analytics.edit ili analytics.manage.users scope, zavisno od operacije.
OAuth flow je isti kao za svaki drugi API u ovom vodiču: kredencijali iz vašeg Cloud projekta, korisnik (vlasnik GA4 naloga ili vi, ako ste dodati kao korisnik na property-ju) odobri pristup, vi dobijete refresh token koji čuvate i koristite za buduće pozive bez ponovnog prijavljivanja.
Google Search Console API
Search Console API pokriva tri stvari koje su relevantne za agenciju koja radi i SEO stranu, ili barem prati organski saobraćaj kao kontekst za Ads performanse: Search Analytics (upiti, klikovi, impresije, pozicija - osnova za svaki SEO izveštaj ili dashboard), URL Inspection (status indeksiranja pojedinačnih URL-ova) i Sitemaps (podnošenje i status sitemap fajlova).
Scope koji vam treba za čitanje je https://www.googleapis.com/auth/webmasters.readonly; za akcije kao što je podnošenje sitemap-a, treba vam širi webmasters scope bez ".readonly" sufiksa.
Važno o granularnosti
Ispravan OAuth scope sam po sebi nije dovoljan. Search Console pristup se dodaje po property-ju (domenu ili URL-prefixu), ne globalno za nalog koji zove API. Ako niste dodati kao korisnik (owner ili full user) na konkretnom property-ju unutar samog Search Console-a, API poziv za taj sajt će vraćati praznu ili grešku, bez obzira na to koliko je vaš Cloud projekat ispravno podešen. Kod agencije sa deset klijenata, to znači deset odvojenih dodavanja pristupa, po jedno za svaki domen.
Google Tag Manager API
Tag Manager API je koristan kad audit ili izmenu tagova, triggera i varijabli radite preko više naloga, umesto da klikćete kroz interfejs svakog kontejnera pojedinačno. Praktičan primer: skripta koja jednom nedeljno prođe kroz sve klijentske GTM kontejnere i proveri da li je Conversion Linker tag prisutan i aktivan, ili koja masovno doda isti trigger na više kontejnera odjednom.
API razlaže pristup na nekoliko scope-ova, zavisno od toga šta radite: tagmanager.readonly za čitanje strukture, tagmanager.edit.containers za izmenu tagova/triggera/varijabli u radnom prostoru, tagmanager.edit.containerversions za kreiranje verzija, i tagmanager.publish za objavljivanje. Za čist audit dovoljan je readonly scope; čim počnete da menjate i objavljujete, trebaju vam sva četiri.
Pazite na rate limite
Tag Manager API ima znatno konzervativnije rate limite (broj upita u minuti) nego, na primer, Google Ads API. Ako pišete skriptu koja prolazi kroz veliki broj tagova ili više kontejnera odjednom, razbijte je u manje batch-eve sa pauzama između poziva - inače ćete udariti u 429 greške (too many requests) usred izvršavanja, obično baš na kontejneru gde vam je najviše stalo da promena prođe čisto.
Merchant Center: Content API i Merchant API
Za svakog ko vodi Shopping kampanje, Merchant Center API rešava jedan konkretan problem: status feed-a i product issues se inače proveravaju ručno, po proizvodu, kroz interfejs koji nije napravljen za brzu proveru desetina hiljada artikala. Programski pristup vam daje feed status, diagnostics podatke i listu product issues (disapproved, warning, missing atributi) u strukturisanom obliku koji možete filtrirati, sortirati i ubaciti u dashboard.
Postoje dve verzije: starija Content API for Shopping v2.1, koja i dalje radi i koju koristi većina postojećih integracija, i noviji, unificiraniji Merchant API, ka kojem Google postepeno usmerava nove integracije. Ako tek počinjete, vredi proveriti zvaničnu dokumentaciju za trenutni status oba API-ja pre nego što se odlučite, jer se granica između njih pomera. Scope za oba je isti: https://www.googleapis.com/auth/content.
Za detaljan setup samog Merchant Center naloga (verifikacija, feed atributi, metode dostave feed-a) imam poseban vodič koji ne ponavljam ovde: Google Merchant Center za Srbiju - kompletan setup vodič.
Data Manager API (Customer Match, server-side)
Ovo je najnoviji dodatak u ovom vodiču, aktivan od 2025. godine nadalje. Data Manager API rešava jedan konkretan problem koji je do sada zahtevao ručan rad: slanje audience i conversion podataka (na primer Customer Match liste) direktno sa servera, bez ručnog izvoza CSV fajla i upload-a kroz Google Ads interfejs. Za agenciju koja vodi CRM integraciju sa Google Ads-om, to znači da nova ili ažurirana lista kupaca može automatski da se sinhronizuje, umesto da neko jednom mesečno preuzme i uploaduje fajl.
Scope koji vam treba je https://www.googleapis.com/auth/datamanager. Ako već radite offline conversion import za B2B klijente, ovo je prirodan sledeći korak - server-side slanje audience podataka radi po sličnoj logici kao i slanje conversion podataka, samo za drugu vrstu signala.
Pregled: koji API za šta
Sedam redova ispod je referenca na koju se možete vratiti kad god podešavate novi Cloud projekat ili dodajete API postojećem.
| API | Čemu služi | Scope (osnovni) | Gde se uključuje |
|---|---|---|---|
| Google Ads API | Reporting, upravljanje kampanjama, bulk izmene | .../auth/adwords | API Center (MCC) + Cloud Console |
| GA4 Data API | Izveštaji, metrike, dimenzije programski | .../auth/analytics.readonly | Cloud Console → API Library |
| GA4 Admin API | Nalozi, property-ji, custom dimenzije | .../auth/analytics.edit | Cloud Console → API Library |
| Search Console API | Search Analytics, URL Inspection, sitemaps | .../auth/webmasters.readonly | Cloud Console → API Library |
| Tag Manager API | Audit i izmena tagova/triggera, publish | tagmanager.readonly / edit.containers / publish | Cloud Console → API Library |
| Merchant Center (Content/Merchant API) | Feed status, diagnostics, product issues | .../auth/content | Cloud Console → API Library |
| Data Manager API | Server-side slanje audience/conversion podataka | .../auth/datamanager | Cloud Console → API Library |
Checklist: setup od nule
Ako počinjete od potpune nule, redosled koraka izgleda ovako. Isti redosled važi bez obzira na to koji od šest API-ja vam je prioritet.
Često postavljana pitanja
Da li mi treba poseban Cloud projekat za svaki API?▼
Šta se dešava ako zaboravim da prebacim OAuth consent screen u Production?▼
Da li API pristup nešto košta?▼
Koji API prvi da podesim ako tek počinjem?▼
Koja je razlika između Content API for Shopping i novog Merchant API?▼
Da li mi treba programer za sve ovo?▼
Da li jedan refresh token pokriva više klijentskih naloga?▼
Treba vam kompletan API setup za agenciju?
Postavljam Cloud projekat, OAuth pristupe i API integracije (Ads, GA4, Search Console, Tag Manager, Merchant Center) i noćnu automatizaciju za agencije i timove koji vode više naloga.
Zakažite besplatnu konsultacijuGoogle Ads API Basic Access
Detaljan vodič za developer token i brand verification.
Google Merchant Center Setup
Kompletan setup naloga, feed atributi i verifikacija.
GA4 i Google Ads Integracija
Kako povezati GA4 podatke sa Google Ads optimizacijom.
Offline Conversion Import za B2B
Server-side slanje conversion podataka preko API-ja.
Besplatni video audit
Dobijte personalizovani video audit vašeg Google Ads naloga
Snimićemo 15-minutni pregled vaših kampanja gde pokazujemo tačno gde gubite novac i šta bi prvi popravili.
Besplatni personalizovani video audit
Želite video pregled vašeg Google Ads naloga?
Lično ću snimiti 15-minutni video u kome prolazim kroz vaše kampanje, pokazujem gde gubite novac i dajem 3 konkretne stvari za popravku odmah. Bez prodaje — samo vrednost.
Šta dobijate:
- 15-min personalizovana video analiza
- 3 konkretna quick wins za implementaciju
- Preporuke za budžet i bidding
Uslovi:
- Ad spend: €1.500+/mesečno
- Aktivan nalog minimum 3 meseca
- eCommerce ili Lead Gen biznis
Ograničeno na 5 audita mesečno. Odgovor u roku od 48h.