Перейти к содержанию
GetProfit
Войти

← Все термины

Google Ads API

Google Ads API — программный интерфейс Google к Google Ads: он позволяет программе читать отчёты и настройки аккаунта и менять его кампании.

Как работает

Приложение входит через OAuth с аккаунтом Google и видит аккаунты, которые этот человек может открыть. Чтение и запись используют одну область доступа (scope), поэтому предел задаёт одна только роль человека. Приложение запрашивает отчёты на GAQL и отправляет изменения запросами mutate. API заменил AdWords API, отключение которого было назначено на 27 апреля 2022 года.

Токены разработчика (developer tokens) отменены 9 сентября 2026 года. Теперь уровень доступа принадлежит проекту Google Cloud, которому принадлежат учётные данные OAuth приложения:

УровеньЧто разрешено
Testтолько тестовые аккаунты; выдаётся при включении API
Explorer2 880 операций в сутки на рабочих аккаунтах
Basic15 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, а не к кампаниям.

Верное и неверное прочтение

  • Неверно: «Приложение запросило только чтение, значит, менять кампании оно не может». Верно: область доступа одна для обоих действий; изменения исключает только аккаунт с ролью «Только чтение».
  • Неверно: «Чтобы начать, нужны управляющий аккаунт и токен разработчика». Верно: теперь доступ запрашивают в Google Cloud Console, а API игнорирует токен, отправленный с вызовами.

Источники