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:

./install.sh agy
# Or include additional client libraries:
./install.sh agy --java --dotnet

Windows（PowerShell）:

.\install.ps1 -Type agy
# Or include additional client libraries:
.\install.ps1 -Type agy -Java -Dotnet

Claude Code

Linux / macOS:

./install.sh claude
# Or include additional client libraries:
./install.sh claude --php --dotnet

Windows（PowerShell）:

.\install.ps1 -Type claude
# Or include additional client libraries:
.\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. アシスタントを操作する

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

主な機能

  • 自然言語による Q&A とコンセプトのガイダンス: 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 の直接実行と変更の安全性: 生成された読み取り専用スクリプトをマネージド仮想環境内で直接実行します。

    • アシスタントに「コードを実行して」または「スクリプトを実行して」と話しかけます。
    • Mutate Safety: 安全性のため、変更オペレーション（作成、更新、削除）は 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:

      ./update.sh agy --context_dir /path/to/your/codebase
# Or for Claude Code:
./update.sh claude --context_dir /path/to/your/codebase

    • Windows（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:

./update.sh agy          # Update Antigravity plugin
./update.sh agy --all    # Include all client libraries

Windows（PowerShell）:

.\update.ps1 -Type agy
.\update.ps1 -Type agy -All

Claude Code

Linux / macOS:

./update.sh claude       # Update Claude Code plugin
./update.sh claude --all # Include all client libraries

Windows（PowerShell）:

.\update.ps1 -Type claude
.\update.ps1 -Type claude -All

アンインストール

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

Antigravity

Linux / macOS:

rm -rf ~/.gemini/config/plugins/google-ads-api-developer-assistant

Windows（PowerShell）:

Remove-Item -Recurse -Force `
  "$HOME\.gemini\config\plugins\google-ads-api-developer-assistant"

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

Claude Code

アクティブな Claude Code セッションの場合:

/plugin uninstall google-ads-api-developer-assistant@google-ads-assistant-local

または、ターミナルから次のコマンドを実行します。

claude plugin uninstall \
  google-ads-api-developer-assistant@google-ads-assistant-local

（省略可）ローカル マーケットプレイス レジストリを削除します。

claude plugin marketplace remove google-ads-assistant-local

コミュニティとサポート

投稿に関するガイドライン

コントリビューションを歓迎します。ガイドラインについては、GitHub リポジトリの CONTRIBUTING.md ファイルをご覧ください。

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