Представляем Google Ads API Developer Assistant версии 3.0.0

Среда, 10 июня 2026 г.

Мы рады сообщить о выпуске версии 3.0.0 Google Ads API Developer Assistant. Это важный этап в развитии Ассистента, который включает модернизацию архитектуры, повышение надежности и более модульный дизайн.

В этом выпуске мы переносим Ассистента на фреймворк агента Google Antigravity и переходим на архитектуру, основанную на навыках. Эти изменения делают Ассистента более надежным, упрощают его обслуживание и сокращают использование токенов.

Что нового в версии 3.0.0?

1. На основе фреймворка Antigravity

Помощник разработчика Google Ads API перешел с gemini-cli на фреймворк агента Antigravity (версия 3.0.0). Обновление базовой платформы обеспечивает более структурированную и надежную среду выполнения. Кроме того, структура каталогов и файлов проекта была обновлена, чтобы полностью соответствовать требованиям Antigravity.

Поддержка gemini-cli прекратится 18 июня 2026 г., как описано в этой записи в блоге Google.

2. Модульная архитектура на основе навыков

Основные возможности Ассистента перенесены в навыки. Вместо того чтобы полагаться на общие неструктурированные инструкции в файле контекста, Ассистент теперь динамически загружает специализированные каталоги инструментов (навыки), прошедшие тестирование. Это значительно снижает вероятность "галлюцинаций" и гарантирует, что задачи будут выполняться в соответствии с точными и проверенными процедурами.

Основные изменения:

  • Проверка GAQL (validate_gaql). Перенесена в отдельный навык. Теперь он включает улучшенные статические проверки запросов для сегментов дат, фильтры click_view для одного дня и границы change_status.
  • Устранение неполадок с конверсиями (troubleshoot_conversions). Заменяет старый инструмент conversions_support_package. Он объединяет все скрипты для устранения неполадок с конверсиями и сводки загрузок, а также тесты в единый каталог навыков.
  • Структурированные команды (explain и step_by_step). Преобразованы в навыки, чтобы обеспечить единообразные структурированные макеты для объяснений.
  • Новое сопоставление аккаунтов (get_cids_under_mcc). Новый навык для получения всех дочерних аккаунтов в управляющем аккаунте (Центре клиентов).
  • Проверка новых объектов (inspect_object). Новый навык для динамического поиска сообщений Protobuf и перечислений на лету, чтобы Ассистент всегда использовал правильные структуры.
  • Новый фильтр для кампаний с максимальной эффективностью (pmax_listing_filter). Новый навык для стандартизации изменений в дереве исключений веб-страниц для групп предложений в кампаниях с максимальной эффективностью.

3. Повышенная согласованность и точность

Мы ввели более строгие правила и требования, чтобы обеспечить высокое качество генерируемого кода и проверки запросов:

  • Явное управление версиями API. Для критически важных навыков, таких как get_cids_under_mcc, validate_gaql и troubleshoot_conversions, теперь требуется явный аргумент api_version, что устраняет неоднозначность.
  • Строгие правила GAQL:
    • В AGENTS.md добавлено правило, запрещающее использовать в запросах GAQL агрегатные функции SQL (например, SUM, COUNT и AVG), поскольку они не поддерживаются.
    • Добавлено правило, согласно которому сначала нужно проверять примечания к выпуску на сайте для разработчиков Google Ads API, чтобы убедиться, что помощник использует актуальную документацию.
    • Упрощенная конфигурация. AGENTS.md была упрощена, что привело к уменьшению начального окна контекста. Документация по дублирующимся конверсиям удалена, чтобы уделить больше внимания навыкам работы с алгоритмическими продажами.

4. Улучшения для разработчиков

Мы внесли несколько улучшений, чтобы сделать процесс разработки быстрее и удобнее:

  • Постоянная виртуальная среда (.venv). Виртуальная среда больше не удаляется в конце сеанса. При запуске Помощник проверяет версию Python в системе и пересобирает .venv, только если доступна более новая версия Python.
  • Умное кеширование версии API. Теперь Помощник кеширует текущую версию Google Ads API с TTL 19 часов. Это позволяет сократить время запуска, избегая лишних сетевых проверок.
  • Улучшенная отладка с помощью постоянных журналов. Теперь сообщения в журналах содержат отметки даты и времени. Файл журнала записывается в каталог .agents/ и больше не сбрасывается при каждом запуске, сохраняя историю для устранения неполадок.

Зачем переходить на новую версию?

Обновление до версии 3.0.0 в основном касается надежности и структуры. Переход на фреймворк Antigravity и модульные навыки позволил сделать Ассистента более предсказуемым и эффективным.

Если вы хотите, чтобы запуск происходил быстрее, проверка GAQL была надежнее, а устранение неполадок – эффективнее, рекомендуем перейти на версию 3.0.0.

Начало работы

Первая установка

  1. Установите Antigravity CLI, следуя инструкциям на странице https://antigravity.google/.
  2. Клонирование помощника 
    git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  3. Запустите скрипт установки.
    • Linux/macOS. Выполните команду ./install.sh (по умолчанию используется поддержка Python, для других языков используйте флаги, например --php или --ruby).
    • Windows. Откройте PowerShell и выполните команду .\install.ps1.

Переход с версии 2.x

  1. Скопируйте весь пользовательский код и данные из папки saved/ в безопасное место за пределами каталога проекта.
  2. Удалите локальный клон Ассистента.
  3. Клонируйте хранилище:
git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  1. Запустите скрипт установки (install.sh или install.ps1), чтобы инициализировать новую среду Antigravity.

Боб Хэнкок (Bob Hancock), команда Google Ads API

Ярлыки: google-ads-api, release