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

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

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

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

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

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

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

Начать

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

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

    (Примечание: Если у вас включена интеграция с оболочкой Antigravity, переход в этот каталог автоматически инициализирует сессию помощника).

  2. Запустите скрипт установки: этот скрипт инициализирует среду разработки и клонирует необходимые клиентские библиотеки Google Ads (Python установлен по умолчанию).

    ./install.sh

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

  3. Настройка учетных данных: Убедитесь, что файл google-ads.yaml (или его аналог на вашем языке программирования) находится в вашей домашней директории.

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

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

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

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

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

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

  • Прямое выполнение API: запускайте сгенерированные скрипты Python только для чтения непосредственно в изолированной виртуальной среде ( .venv ) и просматривайте отформатированные результаты в виде таблиц в терминале.

    • Просто скажите Ассистенту: «Запустить код» или «Выполнить скрипт» .
    • В целях безопасности операции изменения (создание, обновление, удаление) генерируются, но никогда не выполняются.

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

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

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

    • «Почему я не вижу результатов по своему запросу?»
    • "Устранение неполадок при конвертации данных для клиента 123-456-7890." (Создает подробный диагностический отчет в saved/data/ ).

  • Дополнительный контекст: для наглядности добавьте свой собственный код или пользовательские библиотеки.

    • Используйте скрипт update.sh с опцией --context_path для регистрации файлов вашего проекта: none ./update.sh --context_path /path/to/your/codebase
    • Это позволяет Ассистенту учитывать логику вашего приложения при создании ответов или генерации кода на предпочитаемом вами языке.

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

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

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

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

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

Назад
Что такое помощник разработчика Google Ads API?