Google Ads API
Google Ads API — програмний інтерфейс Google до Google Ads: через нього програми читають звіти й налаштування акаунта та змінюють кампанії.
Як працює
Застосунок входить через OAuth з акаунтом Google і бачить акаунти, які може відкрити ця людина. Читання й запис мають один дозвіл (scope), тож межу задає лише роль людини. Застосунок запитує звіти мовою GAQL і надсилає зміни як запити mutate. API замінив AdWords API, який мали вимкнути 27 квітня 2022 року.
Токени розробника скасовано 9 вересня 2026 року. Рівень доступу тепер належить проєкту Google Cloud, якому належать облікові дані OAuth застосунку:
| Рівень | Що доступно |
|---|---|
| Test | лише тестові акаунти; надається, коли ви вмикаєте API |
| Explorer | 2 880 операцій на день на робочих акаунтах |
| Basic | 15 000 на день; потрібна верифікація бренду |
| Standard | без обмежень, після перевірки приблизно 10 робочих днів |
Магазини використовують API для звітності за товарами, вивантажень і автоматизації. Які рішення варто автоматизувати — у матеріалі про автоматизацію Google Ads для інтернет-магазинів.
Де це видно
- Google Cloud Console: сторінка Google Ads API Overview показує рівень доступу проєкту та наступний рівень, на який можна подати заявку.
- Історія змін Google Ads: правки, внесені через API, із позначкою «Google Ads API» або назвою інструмента.
Приклад
Приклад на вигаданому магазині, числа не клієнтські.
Нічний експорт магазину посуду виконує 6 запитів SearchStream, і кожен зараховується як одна операція: 6 на день, у межах рівня Explorer. Інструмент агенції, що виконує ті самі 6 запитів для 500 магазинів, потребує 6 × 500 = 3 000 на день — більше за 2 880 рівня Explorer, тож його проєкту потрібен рівень Basic.
Не плутати з
- Скрипти Google Ads — JavaScript, що виконується всередині Google Ads, для власної логіки без власного сервера.
- Merchant API — інтерфейс до даних про товари в Merchant Center, а не до кампаній.
Правильне й неправильне прочитання
- Неправильно: «Застосунок попросив лише читання, отже, змінювати кампанії він не може». Правильно: дозвіл (scope) для читання й запису один і той самий; змінити кампанії не зможе лише акаунт із роллю «Лише читання» (Read only).
- Неправильно: «Щоб почати, потрібні керівний акаунт і токен розробника». Правильно: тепер доступ запитують у Google Cloud Console, а токен, надісланий разом із викликами, API ігнорує.
Джерела
- Introduction to the Google Ads API (англійською). Перевірено 02.10.2026.
- Developer token і Access levels and permissible use (англійською). Перевірено 02.10.2026.
- Understand the Google Ads access model (англійською) — один дозвіл (scope). Перевірено 02.10.2026.
- API limits and quotas (англійською). Перевірено 02.10.2026.
- Upgrade to the Google Ads API from the AdWords API by April 27, 2022 (Google Ads Developer Blog, англійською). Перевірено 02.10.2026.