Установите и используйте Google Ads API Developer Assistant.

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

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

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

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

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

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

Начать

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

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

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

    ./install.sh

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

  3. Запустите gemini-cli:

    gemini

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

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

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

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

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

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

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

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, если ваш язык программирования по умолчанию — Python, Ruby или PHP. Скрипты, написанные на скомпилированных языках, выполняться не будут из-за политик безопасности.

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

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

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

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

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

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

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

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

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