Навыки работы с API Google Ads

Навыки агентов Google Ads API представляют собой переносимые, самодостаточные модули, содержащие знания, инструкции и рабочие процессы, специфичные для Google Ads API. Навыки агентов Google Ads API работают с ИИ-помощниками, поддерживающими открытый стандарт Agent Skills , включая Google Antigravity и Claude Code.

Эти навыки для агентов разработаны, чтобы помочь ИИ-помощникам понять лучшие практики использования Google Ads API, настроить инструменты и выполнять рабочие процессы с большей точностью и меньшей стоимостью токенов. Список доступных навыков см. в разделе «Доступные навыки» .

Начать

Установите необходимые для вашей среды разработки навыки агента.

Установите навыки агента Google Ads API.

В большинстве случаев навыки агента Google Ads API можно установить в предпочитаемом вами редакторе с помощью одной команды:

Антигравитация

Навыки агента Google Ads API включены в один из пакетов интеграции Build with Google для Antigravity. Вы можете включить этот пакет для глобального доступа в двух местах:

  • В процессе регистрации : установите флажок для подключения к стеку Google Ads API.
  • В настройках : перейдите в «Настройки» > «Настройки персонализации» . В разделе «Создать с помощью плагинов Google» нажмите «Настроить» , затем нажмите «Загрузить» для интеграции с API Google Ads.

Если вам нужен доступ на уровне проекта, выполните следующую команду в каталоге вашего проекта:

npx skills add google/skills --agent=antigravity

Кодекс Клода 

claude plugin marketplace add google/skills
claude plugin install google-ads@skills

Кодекс 

npx skills add google/skills

Курсор

Вы можете установить навыки агента Google Ads API напрямую, добавив конечную точку репозитория GitHub навыка (например, https://github.com/google/skills ) в настройки редактора в разделе пользовательских правил. Для получения более подробной информации см. документацию по правилам курсора .

Другие агенты

Для других ИИ-помощников, поддерживающих открытый стандарт Agent Skills, вы можете установить навыки с помощью NPX:

npx skills add google/skills

Обновите навыки агента Google Ads API.

Чтобы получить все доступные обновления и удалить устаревшие навыки, выполните команду update :

Антигравитация

Интеграции, включенные через Build with Google, управляются и обновляются редактором автоматически.

Если вы установили навыки агента с помощью команды npx , вы можете получить все доступные обновления, выполнив команду update :

npx skills update --all

Кодекс Клода 

claude plugin update google-ads@skills

Кодекс 

npx skills update --all

Курсор 

npx skills update --all

Другие агенты

Для других ИИ-помощников, поддерживающих открытый стандарт Agent Skills, вы можете обновить все активные навыки с помощью NPX:

npx skills update --all

Используйте навыки агента Google Ads API.

Искусственный интеллект-помощники разработаны таким образом, чтобы автоматически использовать навыки всякий раз, когда они обнаруживают, что описание навыка соответствует вашему текущему запросу. Навыки, установленные глобально, остаются неактивными в несвязанных проектах, если контекст вашего запроса не соответствует задачам API Google Ads.

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

Основные компоненты навыка

Каждый навык агента представляет собой специализированный пакет, который предоставляет ИИ-помощнику следующие компоненты:

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

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

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

Сниженная стоимость токенов

Традиционные интеграции ИИ часто загружают огромные объемы документации заранее, что потребляет значительное количество токенов и увеличивает стоимость сессии. Навыки агентов используют поэтапное раскрытие информации для минимизации этих накладных расходов:

  • Первоначально ИИ-помощник проверяет только название и описание навыка, чтобы определить, соответствует ли он вашему запросу.
  • Полные инструкции и справочные материалы по навыку добавляются в активное контекстное окно только тогда, когда помощник определяет, что они необходимы для выполнения вашей конкретной задачи, что позволяет сэкономить место в контекстном окне.

Реализация с использованием ИИ

Вместо того чтобы вручную искать информацию в документации, вы можете описать свои намерения на естественном языке. Навыки помогут вашему ИИ-помощнику выполнять такие задачи, как:

  • Сгенерируйте GAQL-запрос для получения показателей эффективности кампании из моего аккаунта.
  • Напишите скрипт на Python с использованием клиентских библиотек для создания новой кампании.
  • Получайте данные о конверсиях кампании и диагностические данные с помощью API Google Ads.

Полный список доступных навыков см. в разделе «Доступные навыки» .

Используйте эти навыки совместно с сервером Google Ads API MCP.

Навыки агентов разработаны для дополнения сервера протокола контекста модели (MCP) API Google Ads :

  • Сервер Google Ads API MCP : разработан для рабочих процессов разработки с использованием ИИ, позволяя ИИ-помощникам программно взаимодействовать с вашими ресурсами, кампаниями и показателями Google Ads API.
  • Навыки работы с Google Ads API : Предоставление оперативных инструкций и рекомендаций, которые помогут помощнику выполнять задачи с помощью эффективного поэтапного раскрытия информации на основе токенов. Обучение помощника эффективному использованию таких инструментов, как серверная и клиентская библиотеки MCP.

Доступные навыки

Команда Google Ads API предоставляет набор инструментов для работы с Google Ads API:

Навык Описание
google-ads-api-mcp-setup Помогает в настройке и конфигурировании сервера протокола контекста модели (MCP) API Google Ads, упрощая аутентификацию и настройку в локальной среде.
google-ads-api-quickstart Пошагово объясним, как настроить среду разработки, сконфигурировать учетные данные и выполнить первый вызов API Google Ads.

Следующие шаги