Среда, 10 декабря 2025 г.
Представляем Google Ads API Developer Assistant – мощное расширение для Gemini CLI, которое поможет вам оптимизировать рабочие процессы Google Ads API. Этот инструмент позволяет взаимодействовать с Google Ads API на естественном языке, что упрощает получение информации, создание кода и даже извлечение данных непосредственно в терминале.
Помощник будет полезен как новичкам, так и опытным разработчикам Google Ads API.
Что умеет Gemini?
Google Ads API Developer Assistant (версия 1.0) расширяет возможности Gemini CLI за счет следующих ключевых функций:
- Вопросы и ответы на естественном языке. У вас есть вопросы о Google Ads API? Просто попросите.
- Какие типы кампаний доступны?
- "Расскажи об отчетах для кампаний с максимальной эффективностью".
- "Как отфильтровать данные по дате в GAQL?"
- Генерация кода на основе запросов на естественном языке. Опишите, какие данные вам нужны, и помощник сгенерирует запрос на языке GAQL и исполняемый код Python, используя клиентскую библиотеку
google-ads-pythonв качестве контекста, чтобы код соответствовал рекомендациям.- "Покажи кампании с наибольшим количеством конверсий за последние 30 дней".
- "Получить все группы объявлений для клиента 123-456-7890".
- "Найди отклоненные объявления во всех кампаниях".
- Сгенерированный код автоматически сохраняется в каталоге
saved_code/.
- Прямое выполнение API. Запускайте сгенерированные скрипты Python прямо из командной строки. Помощник выполнит вызовы API, предназначенные только для чтения, и покажет результаты, часто в виде аккуратных таблиц в терминале.
- Экспорт в CSV. Нужно сохранить данные? Вы можете легко экспортировать табличные результаты вызовов API в CSV-файл. Просто спросите:
- Сохрани результаты в CSV-файле.
- Файлы сохраняются в каталоге
saved_csv/.
Как это работает?
Это расширение использует способность Gemini CLI использовать контекст из файлов GEMINI.md и настроек в .gemini/settings.json. Указав помощнику пути к локальному клону библиотеки google-ads-python и каталогам с примерами, вы обеспечите релевантную и точную генерацию кода.
Начало работы
Вот что вам понадобится:
Требования
- Знание основных понятий Google Ads API и принципов аутентификации.
- Токен разработчика Google Ads API.
- Настроенный файл учетных данных
google-ads.yamlв домашнем каталоге. - Python версии 3.10 или более поздней.
- Установленный Gemini CLI.
- Локальная копия клиентской библиотеки
google-ads-python. (скрипт настройки может клонировать его за вас).
Подробные инструкции по настройке и примеры приведены в файле README в репозитории GitHub.
Где найти настройки
Google Ads API Developer Assistant доступен на GitHub.
Сообщество и поддержка
Рекомендуем попробовать! Ваше мнение очень важно для нас. Поделитесь им, пройдя опрос. Присоединяйтесь к обсуждению на канале #ads-api-ai-tools в Discord.
Чтобы сообщить об ошибке, предложить новую функцию или обратиться за помощью, используйте вкладку Issues (Проблемы) в репозитории GitHub. Ознакомьтесь с правилами публикации на странице CONTRIBUTING.md.
Успехов в программировании!
Ярлыки: google-ads-api, release