Přejít k obsahu
GetProfit
Přihlásit se

← Všechny pojmy

Google Ads API

Google Ads API je programové rozhraní Googlu k Google Ads, přes které software čte reporty a nastavení účtu a mění jeho kampaně.

Jak to funguje

Aplikace se přihlásí přes OAuth účtem Google a vidí účty, které tento člověk může otevřít. Čtení a zápis sdílejí jeden rozsah oprávnění (scope), takže hranici určuje jen role daného člověka. Reporty aplikace žádá v GAQL a změny posílá jako požadavky mutate. API nahradilo AdWords API, které se mělo vypnout 27. dubna 2022.

Developer tokeny byly zrušeny 9. září 2026. Úroveň přístupu nyní patří projektu Google Cloud, který vlastní přihlašovací údaje OAuth aplikace:

ÚroveňUmožňuje
Testjen testovací účty; udělí se při zapnutí API
Explorer2 880 operací denně na ostrých účtech
Basic15 000 denně; vyžaduje ověření značky
Standardneomezeně, po kontrole trvající asi 10 pracovních dnů

E-shopy používají API pro přehledy podle produktu, exporty a automatizaci. Která rozhodnutí automatizovat, popisuje text automatizace Google Ads pro e-shopy.

Kde to uvidíte

  • Google Cloud Console: přehledová stránka Google Ads API (Overview) ukazuje úroveň přístupu projektu a další úroveň, o kterou lze požádat.
  • Historie změn Google Ads: úpravy provedené přes API, označené „Google Ads API“ nebo názvem nástroje.

Příklad

Ukázkový obchod, nejde o data klientů.

Noční export obchodu se stolním nádobím spouští 6 dotazů SearchStream a každý se počítá jako jedna operace: 6 denně, v rámci úrovně Explorer. Agenturní nástroj, který stejných 6 dotazů spouští pro 500 obchodů, potřebuje 6 × 500 = 3 000 denně, nad limit úrovně Explorer 2 880, takže jeho projekt potřebuje úroveň Basic.

Nezaměňovat s

  • Skripty Google Ads — kód v JavaScriptu, který běží uvnitř Google Ads, pro vlastní logiku bez vlastního serveru.
  • Merchant API — rozhraní k produktovým datům v Merchant Center, ne ke kampaním.

Správný a chybný výklad

  • Špatně: „Aplikace žádala jen o čtení, takže nemůže měnit kampaně.“ Správně: rozsah oprávnění je pro obojí stejný; změny vylučuje jedině účet s rolí Read only (jen pro čtení).
  • Špatně: „Pro začátek potřebujeme účet správce a developer token.“ Správně: přístup nyní žádáte v Google Cloud Console a API token odeslaný s voláními ignoruje.

Zdroje