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

Четверг, 26 февраля 2026 г.

Это крупное обновление превращает помощника из мощного инструмента генерации кода в проактивного партнера по устранению неполадок и автоматизации для разработчиков Google Рекламы. С момента выпуска версии 1.6.0 мы прислушивались к вашим отзывам и сосредоточились на самых сложных аспектах разработки API: диагностике, согласованности и настройке.

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

1. Простая установка и обслуживание

Настройка многоязычной среды разработки не должна быть сложной.

  • Настройка одной командой. Используйте новый флаг --install-deps с install.sh или install.ps1, чтобы сразу обработать зависимости pip, composer и bundler.
  • Единая структура каталогов. Весь сгенерированный код, экспортированные CSV-файлы и диагностические отчеты теперь хранятся в одном каталоге saved/ с подкаталогами для каждого типа выходных данных.
  • Обновление одной командой. Когда выходит новая версия API и клиентских библиотек, вам нужно выполнить команду update.sh, чтобы начать работу с последней версией. Вы также можете использовать update.sh, чтобы добавить в контекст дополнительные клиентские библиотеки.

2. Устранение неполадок с агентными конверсиями

Отслеживание офлайн-конверсий – одна из самых мощных и в то же время сложных функций Google Ads API. Поиск причин, по которым конверсия не была атрибутирована, может быть трудоемким процессом, выполняемым вручную.

В версии 2.0 мы добавили специальный набор инструментов для устранения неполадок и диагностики конверсий.

  • Новый скрипт: api_examples/collect_conversions_troubleshooting_data.py
  • Новая команда: /conversions_support_data

Скрипт создает стандартные отчеты для устранения неполадок с конверсиями и предоставляет Ассистенту контекст, необходимый для решения проблем.

Эту команду лучше всего использовать после того, как Ассистент проанализирует проблему с конверсиями и попытается ее решить. Если это не так и вам нужно обратиться в службу поддержки, эта команда проанализирует настройки клиента, действия-конверсии и сводки загрузок, чтобы создать структурированный диагностический отчет на основе уже выполненного анализа. Она даже автоматически выявляет "нездоровые" состояния и высокие показатели сбоев, экономя вам часы на изучение журналов. Результаты сохраняются в текстовом файле, который можно прикрепить к запросу в службу поддержки.

3. Создано для последней версии API (v23)

Версия 2.0 полностью поддерживает Google Ads API версии 23. Мы обновили все интерактивные примеры, а внутренний контекст Помощника теперь оптимизирован для последних ресурсов и полей, поэтому сгенерированный код можно сразу использовать в рабочей среде.

4. Автоматизация с помощью хуков сеанса

Мы добавили хуки SessionStart и SessionEnd, чтобы сделать вашу работу по-настоящему удобной.

  • Автоматическая настройка. Теперь в начале сеанса помощник может автоматически находить файл конфигурации в каталоге $HOME. Он копирует его в подкаталог config в каталоге проекта. Python – предпочтительный язык для запросов к API Gemini. Если вы используете другой язык, библиотека считывает файл конфигурации и создает временный файл google-ads.yaml в папке config для своих запросов, но продолжает отвечать в коде на выбранном вами языке.
  • Автоматическая очистка. Временные конфигурации удаляются при выходе, что позволяет поддерживать порядок в рабочей области и защищать учетные данные.

5. Улучшенная проверка GAQL

Создавать сложные запросы GAQL стало проще, чем когда-либо. Мы обновили GEMINI.md и conversions/GEMINI.md, добавив строгие правила проверки для последних пограничных случаев API, включая улучшенную обработку сегментов дат и требований к конечному диапазону. Теперь Помощник выявляет логические ошибки до выполнения запроса.

6. Навыки

Навык – это мини-плагин или шаблон поведения. Общий контекст (например, файл GEMINI.md) предоставляет фоновую информацию, а навык "загружается" в ИИ, только когда ему нужно выполнить сложную процедурную задачу, например получить текущую версию этого расширения. Вы не выполняете навык напрямую. Gemini сам решает, когда ему нужен доступ к экрану.

Хотя это все ещё экспериментальная функция, мы включили ее в этот выпуск, чтобы дополнить использование хуков для инициализации и очистки сеанса.

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

Переход от версии 1.6.0 к версии 2.0.0 – это не просто добавление новых функций, а повышение надежности. Благодаря интеграции глубоких знаний об API с автоматизированными инструментами диагностики в версии 2.0 сокращается цикл проб и ошибок, который часто замедляет интеграцию API.

Независимо от того, отлаживаете ли вы загрузку конверсий или создаете сложные конвейеры отчетов, версия 2.0 предоставляет инструменты, позволяющие работать быстрее и увереннее.

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

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

Обновление предыдущей версии

  • Скопируйте весь пользовательский код из файлов saved_code/ и saved_csv/ в безопасное место.
  • Удалите локальную копию Google Ads API Developer Assistant, удалив каталог проекта и все подкаталоги и файлы.
  • git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  • В каталоге проекта запустите install.sh или install.ps1, чтобы установить расширение и клиентские библиотеки.

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

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