Помощник разработчика Google Ads API

Google Ads API Developer Assistant — это мощное расширение для Gemini CLI, разработанное для ускорения рабочих процессов с Google Ads API. Assistant позволяет взаимодействовать с Google Ads API, используя естественный язык, что упрощает задавание вопросов, генерацию кода, получение данных и устранение неполадок непосредственно в терминале.

Преимущества

  • Повысьте производительность: тратьте меньше времени на поиск документации и написание шаблонного кода.
  • Упростите сложные задачи: генерируйте код на языке запросов Google Ads (GAQL) и код клиентской библиотеки на основе простых подсказок на английском языке.
  • Изучите API: разберитесь в концепциях API и посмотрите, как запросы на естественном языке преобразуются в исполняемый код.
  • Интерактивная отладка: получите помощь в понимании ошибок и пошаговые инструкции по устранению неполадок.
  • Оптимизированный рабочий процесс: осуществляйте разработку и тестирование исключительно через командную строку.

Предварительные требования

Прежде чем начать, убедитесь, что у вас есть следующее:

  1. Доступ к API Google Ads:

  2. Программное обеспечение:

    • Python 3.10 или новее. Python является языком программирования по умолчанию, поэтому он должен быть установлен и добавлен в переменную PATH.
    • Установлен Gemini CLI .
    • jq (процессор JSON из командной строки). Скрипт установки попытается установить его, если он отсутствует.

  3. Репозиторий:

    • Локальная копия репозитория google-ads-api-developer-assistant с GitHub:

Начать

  1. Перейдите в каталог проекта:

    cd <full path>/google-ads-api-developer-assistant

  2. Запустите скрипт настройки: Этот скрипт настраивает Gemini CLI для использования контекстных файлов GEMINI.md помощника и необходимых инструментов.

    ./setup.sh

    Если вы используете Windows, запустите скрипт PowerShell setup.ps1 .

  3. Запустите интерфейс командной строки Gemini:

    gemini

  4. Взаимодействуйте с Ассистентом: теперь вы можете задавать вопросы или отдавать команды на естественном языке.

Основные характеристики

  • Вопросы и ответы на естественном языке: Задавайте вопросы о функциях API Google Ads, передовых методах или конкретных ресурсах.

    • «Какие типы кампаний доступны?»
    • «Как выполнить фильтрацию по дате в GAQL?»
    • «Объясните разницу между click_view и impression_view».

  • Генерация кода: Создание GAQL-запросов и исполняемых фрагментов кода на Python.

    • «Покажите мне рекламные кампании с наибольшим количеством конверсий за последние 30 дней».
    • "Получить все имена групп объявлений, включенных для кампании с идентификатором 12345."
    • "Найти отклоненные объявления во всех кампаниях." Сгенерированный код сохраняется в каталоге saved_code/ .

  • Прямое выполнение API: запускайте сгенерированные скрипты Python только для чтения непосредственно из командной строки Gemini и просматривайте отформатированные результаты в терминале. После того, как Ассистент сгенерирует код, на экране появится подсказка: 

To run this script, you will need to replace YOUR_CUSTOMER_ID with your actual
Google Ads customer ID and execute the following command in
your shell: <command>

Введите команду run , и скрипт будет выполнен в контексте Assistant.

  • Экспорт в CSV: Сохранение табличных результатов вызовов API в CSV-файл.

    • "Сохранить результаты в CSV-файл." Файлы сохраняются в каталоге saved_csv/ .

  • Помощь в устранении неполадок: получите помощь в решении проблем с сообщениями об ошибках или неожиданным поведением API.

    • "У меня возникла ошибка 'AuthenticationError.OAUTH_TOKEN_INVALID', что мне делать?"
    • «Почему я не вижу результатов по своему запросу?»

Примеры вариантов использования

  • Сообщение:
    • "Получите 5 ключевых слов с наибольшей стоимостью за прошлый месяц для клиента 12345678."
  • Структура счета:
    • «Перечислите все названия кампаний и их идентификаторы».
  • Поиск неисправностей:
    • «Я загрузил 100 конверсий, но в пользовательском интерфейсе отображается только 78. Как я могу отладить это с помощью API?»
  • Обучение:
    • «Покажите, пожалуйста, как создать кампанию Performance Max с помощью API».

Сообщество и поддержка

Правила внесения пожертвований

Вклад приветствуется! Инструкции по внесению изменений см. в файле CONTRIBUTING.md в репозитории GitHub.