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 スタックのチェックボックスをオンにします。
- 設定の場合:
- [設定] > [カスタマイズ] に移動します。
- [Build with Google Plugins] で [Customize] をクリックし、Google Ads API 統合の [Download] をクリックします。
プロジェクト レベルのアクセスを希望する場合は、プロジェクトのディレクトリで次のコマンドを実行します。
npx skills add google/skills --agent=antigravity
Claude Code
claude plugin marketplace add google/skills
claude plugin install google-ads@skills
Codex
npx skills add google/skills
Cursor
Google Ads API エージェント スキルを直接インストールするには、エディタの設定のカスタムルールに、スキルの GitHub リポジトリ エンドポイント（https://github.com/google/skills など）を追加します。詳細については、カーソルルールのドキュメントをご覧ください。
他のエージェント
オープン エージェント スキル標準をサポートする他の AI アシスタントの場合は、NPX を使用してスキルをインストールできます。
npx skills add google/skills
Google Ads API エージェント スキルを更新する
update コマンドを実行すると、利用可能なすべての更新を取得し、古いスキルをクリーンアップできます。
Antigravity
Google で構築を通じて有効にした統合は、エディタによって自動的に管理および更新されます。
npx コマンドを使用してエージェント スキルをインストールした場合は、update コマンドを実行して、利用可能なすべての更新を取得できます。
npx skills update --all
Claude Code
claude plugin update google-ads@skills
Codex
npx skills update --all
Cursor
npx skills update --all
他のエージェント
オープン エージェント スキル標準をサポートする他の 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-mcp-setup |
Google 広告 API の Model Context Protocol（MCP）サーバーのセットアップと構成を支援し、ローカル環境での認証と構成を簡素化します。 |
google-ads-api-quickstart |
デベロッパー環境の設定、認証情報の設定、Google Ads API への最初の API 呼び出しを行う手順を説明します。 |