Google Ads API エージェントのスキル

Google Ads API エージェント スキルは、Google Ads API 固有の知識、手順、ワークフローを含む、移植可能な自己完結型のモジュールです。Google Ads API エージェント スキルは、Google Antigravity や Claude Code など、オープン エージェント スキル標準をサポートする AI アシスタントと連携します。

これらのエージェント スキルは、AI アシスタントが Google Ads API のベスト プラクティスを理解し、ツールを構成して、より高い精度と低いトークン費用でワークフローを実行できるように設計されています。利用可能なスキルの一覧については、利用可能なスキルをご覧ください。

始める

開発環境に適したエージェント スキルをインストールします。

Google Ads API エージェント スキルをインストールする

ほとんどの場合、Google Ads API エージェント スキルは、次の 1 つのコマンドを使用して任意のエディタにインストールできます。

Antigravity

Google Ads API エージェント スキルは、Antigravity の Build with Google 統合バンドルの 1 つとして含まれています。このバンドルは、次の 2 つのポイントでグローバルレベルのアクセスを有効にできます。

  • オンボーディング中: Google Ads API スタックのチェックボックスをオンにします。
  • [設定] で次のように操作します。
    1. [設定] > [カスタマイズ] に移動します。
    2. [Build with Google プラグイン] で [カスタマイズ] をクリックし、Google Ads API 統合の [ダウンロード] をクリックします。

プロジェクト レベルのアクセス権を付与する場合は、プロジェクトのディレクトリで次のコマンドを実行します。

npx skills add google/skills/skills/ads --agent=antigravity

Claude Code 

npx skills add google/skills/skills/ads --agent=claude-code

Codex 

npx skills add google/skills/skills/ads --agent=codex

Cursor

Google Ads API エージェントのスキルを直接インストールするには、エディタの設定のカスタムルールで、スキルの GitHub リポジトリ エンドポイント（https://github.com/google/skills など）を追加します。詳細については、GitHub からスキルをインストールする方法に関する Cursor のドキュメントをご覧ください。

npx を使用してスキルをインストールすることもできます（Node.js が必要）。

npx skills add google/skills/skills/ads --agent=cursor

他のエージェント

オープンな Agent Skills 標準をサポートする他の AI アシスタントの場合は、npx を使用してスキルをインストールできます（Node.js が必要です）。

npx skills add google/skills/skills/ads

Google Ads API エージェントのスキルを更新する

利用可能なすべての更新を取得し、古いスキルをクリーンアップするには、update コマンドを実行します。

Antigravity

Build with Google で有効にした統合は、エディタによって自動的に管理、更新されます。

npx コマンドを使用してエージェント スキルをインストールした場合は、update コマンドを実行して、利用可能なすべての更新を取得できます。

npx skills update --all

Claude Code 

npx skills update --all

Codex 

npx skills update --all

Cursor 

npx skills update --all

他のエージェント

オープンな Agent Skills 標準をサポートする他の AI アシスタントの場合は、npx を使用して、アクティブなスキルをすべて更新できます。

npx skills update --all

Google Ads API エージェント スキルを使用する

AI アシスタントは、スキルの説明が現在のリクエストと一致すると判断されたときに、スキルを自動的に使用するように設計されています。グローバルにインストールされたスキルは、プロンプト コンテキストが Google Ads API タスクと一致しない限り、関連のないプロジェクトでは休止状態のままになります。

スキルは、エージェント チャットに「/」と入力してスキル名を検索することで、手動で呼び出すこともできます。

スキルのコア コンポーネント

各エージェント スキルは、AI アシスタントに次のコンポーネントを提供する特殊なパッケージです。

  • 専門的な指示: コンテキスト ウィンドウに挿入される詳細なプロンプト指示。GAQL クエリの生成、OAuth 認証情報の構成、一般的なエラーコードの処理についてアシスタントをガイドします。
  • ベスト プラクティス: Google Ads API DevRel チームが定義した、標準的なパフォーマンス、セキュリティ、統合に関する推奨事項。
  • 自動化スクリプト: タスクをローカルで実行するためにスキル パッケージに含まれている実行可能スクリプト（環境検証やワークスペースの設定など）。

スキルを使用するメリット

エージェント スキルは、すべての会話に大量の指示を読み込むオーバーヘッドなしで、必要に応じて専門知識を使用してアシスタントの機能を拡張します。

トークン費用の削減

従来の AI 統合では、大量のドキュメントが事前に読み込まれることが多く、トークンが大量に消費され、セッション費用が増加していました。エージェント スキルでは、段階的開示を使用してこのオーバーヘッドを最小限に抑えます。

  • AI アシスタントは、まずスキルの名前と説明のみをチェックして、リクエストに関連しているかどうかを確認します。
  • スキルの詳細な手順とリファレンスは、特定のタスクに必要であるとアシスタントが判断した場合にのみ、アクティブなコンテキスト ウィンドウに追加されます。これにより、コンテキスト スペースを節約できます。

AI ガイド付きの実装

ドキュメントを手動で検索する代わりに、自然言語でインテントを記述できます。スキルは、次のようなタスクを実行するよう AI アシスタントに指示します。

  • アカウントからキャンペーンのパフォーマンス指標を取得する GAQL クエリを生成します。
  • クライアント ライブラリを使用して、新しいキャンペーンを作成する Python スクリプトを作成する。
  • Google Ads API を使用して、キャンペーンのコンバージョン データと診断データを取得します。

利用可能なスキルの一覧については、利用可能なスキルをご覧ください。

Google Ads API MCP サーバーとともにスキルを使用する

エージェント スキルは、Google Ads API Model Context Protocol（MCP）サーバーを補完するように設計されています。

  • Google Ads API MCP サーバー: AI を活用した開発ワークフロー用に設計されており、AI アシスタントが Google Ads API のリソース、キャンペーン、指標をプログラムで操作できるようにします。
  • Google Ads API エージェントのスキル: トークン効率の高い段階的な開示を通じて、アシスタントがタスクを実行する方法を説明するプロンプト手順と推奨事項を提供します。MCP サーバーやクライアント ライブラリなどのツールを効果的に使用する方法をエージェントに指示します。

利用可能なスキル

Google Ads API チームは、Google Ads API を使用して構築するための一連のスキルを提供しています。

スキル 説明
google-ads-api-account-diagnostics Google Ads API MCP サーバーを使用して、コンバージョンの損失、リード数の減少、広告ランク、入札単価、予算によるインプレッション シェア損失率など、Google 広告アカウントのパフォーマンスの問題を診断します。
google-ads-api-mcp-setup Google Ads API Model Context Protocol（MCP）サーバーの設定と構成を支援し、ローカル環境での認証と構成を簡素化します。
google-ads-api-quickstart デベロッパー環境の設定、認証情報の構成、Google Ads API への最初の API 呼び出しについて説明します。

次のステップ