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. アシスタントとやり取りする

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

主な機能

  • 自然言語による Q&A: Google Ads API の機能、ベスト プラクティス、特定のリソースについて質問します。

  • 自然言語の質問と概念的なガイダンス: 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 デベロッパー アシスタントとは