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 コントラクト、組み込みのスラッシュ コマンド、専用のドメインスキルを使用して、永続的なコンテキスト、堅牢な安全境界、自動検証パイプラインを維持します。アーキテクチャと設計の概要については、Google Ads API Developer Assistant とはをご覧ください。

前提条件

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

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

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

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

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

    • Claude Code: /get-cids <manager_cid>
    • 自然言語: 「マネージャー 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 デベロッパー アシスタントとは