Google Ads API Developer Assistant をインストールして使用する

Google Ads API Developer Assistant は、Google Ads API の深いドメインの専門知識を AI コーディング環境に直接取り込みます。自然言語プロンプトと組み込みのスラッシュ コマンドを使用して、クエリの作成、クライアント ライブラリ コードの生成、読み取り専用 API 呼び出しの実行、アドホック レポートのストリーミング、統合のトラブルシューティングを行います。

アシスタントは、モジュラー プラグインとして Google Antigravity と Claude Code エージェント フレームワーク（v4.0.0）用に構築されています。AGENTS.md と CLAUDE.md のコントラクト、組み込みのスラッシュ コマンド、専門的なドメイン スキルを使用して、永続的なコンテキスト、堅牢な安全境界、自動化された検証パイプラインを維持します。

前提条件

Firebase を追加する前に、次の準備をしてください。

  1. Google Ads API へのアクセス:

  2. ソフトウェア:

始める

リポジトリのクローンを作成し、プラットフォーム固有のインストール スクリプトを実行し、認証情報を構成して、プラグインを有効にするには、次の手順を行います。

1. リポジトリのクローンを作成する

リポジトリをローカルマシンにクローンし、プロジェクト ディレクトリに移動します。

git clone https://github.com/googleads/google-ads-api-developer-assistant
cd google-ads-api-developer-assistant

2. インストール スクリプトを実行します。

ターゲット プラットフォームのインストール スクリプトを実行します。デフォルトでは、Python クライアント ライブラリが含まれています。必要に応じて、追加のクライアント ライブラリ（--php、--ruby、--java、--dotnet、--all）を含めることができます。

Antigravity

Linux / macOS: ```bash ./install.sh agy

または、追加のクライアント ライブラリを含めます。

./install.sh agy --java --dotnet ```

Windows（PowerShell）: ```powershell .\install.ps1 -Type agy

または、追加のクライアント ライブラリを含めます。

.\install.ps1 -Type agy -Java -Dotnet ```

Claude Code

Linux / macOS: ```bash ./install.sh claude

または、追加のクライアント ライブラリを含めます。

./install.sh claude --php --dotnet ```

Windows（PowerShell）: ```powershell .\install.ps1 -Type claude

または、追加のクライアント ライブラリを含めます。

.\install.ps1 -Type claude -Php -Dotnet ```

3. 認証情報の構成

API 構成ファイル（google-ads.yaml、google_ads_php.ini、google_ads_config.rb など）が $HOME ディレクトリに配置されていることを確認します。

（省略可）デフォルトの顧客 ID を構成するには、顧客 ID 番号を config/customer_id.txt に直接入力します（例: 1234567890）。config/api_version.txt でアクティブな API バージョンを検査または固定することもできます。

4. プラグインを有効にする

  • Antigravity: Antigravity / agy ホスト セッションを再起動して、プラグインを読み込みます。
  • Claude Code: アクティブな Claude Code セッションで、/reload-plugins を実行するか、claude を再起動します。

5. アシスタントとやり取りする

アシスタントは、ターミナルで自然言語プロンプトまたは専用のスラッシュ コマンドを使用して操作できます。

主な機能

  • 自然言語の質問と概念的なガイダンス: Google Ads API の機能、アーキテクチャ ルール、特定のリソースについて質問します。アシスタントは、一般的な LLM トレーニングのみに依存するのではなく、公式の API 定義に基づいて回答を生成します。

    • 「提供されているキャンペーン タイプの組み合わせは、次のうちどれですか？」
    • 「GAQL で日付でフィルタするにはどうすればよいですか？」
    • 「click_view と impression_view の違いを説明してください。」
    • 「共有セットとは何ですか？どのように使用すればよいですか？」
    • Claude Code のスラッシュ コマンド: /explain、/step-by-step、/assistant-tutorial

  • 根拠のあるクライアント ライブラリのコード生成: 公式の Google 広告クライアント ライブラリ（Python、Java、PHP、.NET、Ruby）を使用して、テスト済みの慣用的なコードを生成します。

    • 「過去 30 日間でコンバージョン数が最も多いキャンペーンを表示して。」
    • 「顧客 123-456-7890 の有効な広告グループ名をすべて取得します。」
    • 「P-MAX キャンペーンを作成するコードを記述します。」生成されたコードは saved/code/ ディレクトリに保存されます。

  • プログラムによる GAQL クエリの検証: 実行前に、API メタデータ、フィールドの互換性、インプレッションなしのルール、日付セグメンテーションに対して、複雑なクエリを自動的にドライランして検証します。

    • Claude Code: /validate-gaql
    • 自然言語: validate: SELECT campaign.id FROM campaign

  • オブジェクトと Protobuf スキーマの検査: リモート メタデータのオーバーヘッドなしで、アクティブな API バージョンのリソース構造、ネストされたフィールド、データ型、列挙値を動的に検査します。

    • Claude Code: /inspect-object <resource_or_enum>
    • 自然言語: 「キャンペーン リソースを検査する」

  • アドホック ライブ レポートと CSV エクスポート: パフォーマンス データを平易な英語でリクエストします。アシスタントは、アカウントに対して GAQL クエリを直接構築、検証、実行し、フォーマットされたテーブルをターミナルにライブ ストリーミングします。

    • 「お客様 123-456-7890 の先月の費用上位 5 つのキーワードを表示して。」
    • 「結果を CSV ファイルとして保存します。」（saved/csv/ にエクスポートします）。

  • API の直接実行と変更の安全性: 生成された読み取り専用スクリプトをマネージド仮想環境内で直接実行します。

    • アシスタントに「コードを実行して」または「スクリプトを実行して」と話しかけるだけです。
    • 安全性の変更: 安全性のため、変更オペレーション（作成、更新、削除）は saved/code/ に生成されますが、アシスタントによって直接実行されることはありません。アシスタントの外部で手動で確認して実行します。

  • 高度な診断とコンバージョンのトラブルシューティング: オフライン コンバージョン アップロードのエラーを調査し、アップロード ファイルを事前に検証して、詳細な診断レポートを生成します。

    • Claude Code: /troubleshoot-conversions
    • 自然言語: 「お客様 123-456-7890 のコンバージョンのトラブルシューティングを行ってください。」 （レポートは saved/data/ に保存されます）。

  • MCC アカウントの階層マッピング: サブアカウントの顧客 ID を取得し、マネージャー アカウントの階層をマッピングします。

    • Claude Code: /get-cids <manager_cid>
    • Natural Language: 「マネージャー 123-456-7890 のすべてのクライアント顧客 ID を取得して」

  • P-MAX のリスティング フィルタと除外: アセット グループの商品パーティション ツリーとウェブページ URL の除外を生成します。

    • Claude Code: /pmax-filter
    • 自然言語: 「P-MAX キャンペーンのウェブページ除外フィルタを作成して」

  • コードベースの追加コンテキスト: アプリケーション ロジックとカスタム アーキテクチャをアシスタントの推論に登録します。

    • Linux / macOS: bash ./update.sh agy --context_dir /path/to/your/codebase # Or for Claude Code: ./update.sh claude --context_dir /path/to/your/codebase
    • Windows（PowerShell）: powershell .\update.ps1 -Type agy -ContextDir C:\path\to\your\codebase

Claude Code のスラッシュ コマンドのリファレンス

Claude Code を使用する場合、次の組み込みスラッシュ コマンドを使用できます。Google Antigravity では、主な機能で説明したように、自然言語プロンプトまたは validate_gaql や inspect_object などのスキルツール名を使用して、これらの同じ機能を呼び出します。

スラッシュ コマンド 目的 例
/validate-gaql GAQL の構文、互換性、ルールを検証します。 /validate-gaql
/inspect-object Protobuf のフィールド、型、列挙型を検査します。 /inspect-object Campaign
/get-cids MCC 階層とクライアント CID を解決します。 /get-cids 1234567890
/troubleshoot-conversions オフライン コンバージョン アップロードの診断を実行します。 /troubleshoot-conversions
/pmax-filter P-MAX の商品リスティング フィルタと除外を生成します。 /pmax-filter
/explain 4 部構成の説明を提示します。 /explain shared set
/step-by-step マルチフェーズのタスク実行プランを策定します。 /step-by-step upload conversions
/assistant-tutorial 11 ステップのインタラクティブなチュートリアルを実行します。 /assistant-tutorial

メンテナンスと更新

リポジトリ、プラグインのインストール、クライアント ライブラリを更新するには:

Antigravity

Linux / macOS: bash ./update.sh agy # Update Antigravity plugin ./update.sh agy --all # Include all client libraries

Windows（PowerShell）: powershell .\update.ps1 -Type agy .\update.ps1 -Type agy -All

Claude Code

Linux / macOS: bash ./update.sh claude # Update Claude Code plugin ./update.sh claude --all # Include all client libraries

Windows（PowerShell）: powershell .\update.ps1 -Type claude .\update.ps1 -Type claude -All

アンインストール

アシスタント プラグインをアンインストールするには:

Antigravity

Linux / macOS: bash rm -rf ~/.gemini/config/plugins/google-ads-api-developer-assistant

Windows（PowerShell）: powershell Remove-Item -Recurse -Force "$HOME\.gemini\config\plugins\google-ads-api-developer-assistant"

その後、Antigravity ホスト セッションを再起動します。

Claude Code

アクティブな Claude Code セッションで: none /plugin uninstall google-ads-api-developer-assistant@google-ads-assistant-local

または、ターミナルから次のように実行します。 bash claude plugin uninstall google-ads-api-developer-assistant@google-ads-assistant-local

（省略可）ローカル Marketplace レジストリを削除します。 bash claude plugin marketplace remove google-ads-assistant-local

コミュニティとサポート

コード提供に関するガイドライン

ご協力をお待ちしております。ガイドラインについては、GitHub リポジトリの CONTRIBUTING.md ファイルをご覧ください。

前へ
Google Ads API デベロッパー アシスタントとは