Google Ads API Assistant больше не обновляется поверх старой версии

Обновить Google Ads API Developer Assistant поверх старой версии больше не получится. 25 августа вышла сборка 4.0.0, и она несовместима ни с чем, что было раньше: у кого ассистент уже стоит в рабочем проекте, тому придётся снести его и поставить заново инсталлятором под свою систему. Иначе инструмент просто не подхватится.

Причина — в архитектуре. Раньше ассистент жил как локальный проект внутри рабочей папки, теперь это глобальный плагин: ставится один раз на систему и доступен в любом проекте. Именно этот переход и сделал апдейт «на месте» невозможным — в описании релиза команда прямо называет его несовместимым с предыдущими версиями. Разбор релиза опубликовал PPC Land: предыдущая крупная версия выходила в феврале, 4.0 подоспела через шесть дней после Google Ads API v25.1.

Что внутри:

• 10 slash-команд — от /validate-gaql и /inspect-object до /troubleshoot-conversions, /pmax-filter и /sync-client-libs;
• локальная валидация GAQL: поля, ресурсы и условия по датам проверяются детерминированно за один шаг вместо трёх-четырёх кругов отладки через модель;
• генерация кода под Python, Java, PHP, .NET и Ruby — напрямую выполняются только Python, PHP и Ruby, Java и C# требуют компиляции;
• поддержка сразу двух сред: Antigravity от Google и Claude Code.

Последний пункт заметнее прочих: рекламный инструментарий Google официально живёт уже не только в собственной экосистеме.

Для агентств это про рутину: сборка отчётов, выгрузки по кампаниям, разбор конверсий и фильтры Performance Max перестают упираться в ручную сверку схемы API. Ошибку в имени поля или в диапазоне дат ассистент ловит до запроса, а не после очередного пустого ответа.

Перейти на 4.0 можно в несколько шагов:

• проверить текущую версию командой /ext-version, если ассистент уже установлен;
• удалить старую локальную сборку из проекта, чтобы не тащить конфликт конфигов;
• поставить 4.0 инсталлятором под свою ОС и проверить доступ к аккаунтам через /get-cids;
• прогнать рабочие GAQL-запросы через /validate-gaql — экономия на токенах и времени отладки видна сразу.

Шесть дней между выходом Google Ads API v25.1 и обновлением ассистента — срок сам по себе небольшой, но заметнее другое: инструмент теперь официально работает сразу в двух экосистемах — собственной и в Claude Code.

Полезно по теме: Аудит контекстной рекламы