Google Ads API Developer Assistant（v4.0.0）は、一般的な chatbot ではありません。これは、Google Antigravity と Claude Code エージェント フレームワーク上に構築された、AI を活用した広告エンジニアリング専用のミッション コントロール システムです。
自然言語の Q＆A とビジネス固有のコンテキスト
アシスタントとやり取りするには、平易な自然言語で質問やリクエストを行います。アシスタントは、インテントを分析し、公式の API スキーマを参照して、明確な説明、プロダクション レディなコード、ライブデータを提供します。
- 自然言語による説明: Google Ads API のコンセプト、リソース階層、レポート指標、セグメンテーション ルールについて質問すると、明確なコンセプトの概要とアーキテクチャの説明が返されます。
- ターゲット コードの生成: タスクに実装が必要な場合、アシスタントは、プログラミング言語とユースケースに合わせて調整された、慣用的な本番環境対応のクライアント ライブラリ コード スニペット、ミューテーション スクリプト、GAQL クエリを提供します。
- トラブルシューティングとエラー診断: API エラー メッセージ、gRPC ステータス コード、予期しない統合動作を貼り付けます。アシスタントは根本原因を診断し、問題が発生した理由を説明して、必要なコード修正または構成修正を提供します。
- アドホック レポート: アカウントのパフォーマンス データとキャンペーンの指標を、自然な言葉でリクエストできます。アシスタントは、GAQL クエリを構築、検証、実行して、アカウントに対して直接実行し、フォーマットされた結果をターミナルに表示するか、CSV にエクスポートします。
- コードベースからのビジネス固有のコンテキスト:
--context_dir設定パラメータを使用して、独自のプロジェクト リポジトリとコードベースを登録します。既存のデータ パイプライン、ヘルパー ユーティリティ、ビジネス ロジックを分析することで、アシスタントは説明、トラブルシューティング、生成されたコードを調整し、内部システムとシームレスに統合します。
全体像: 高いコンプライアンス要件による摩擦を解消する
このアシスタントが解決する根本的な問題は、認知過負荷と技術的な労力です。
Google Ads API は、利用可能な API の中で最も強力なものの 1 つですが、最も複雑なものの 1 つでもあります。厳格なバージョニング、独自のクエリ言語（GAQL）、深くネストされたプロトコル バッファ構造、厳格な安全要件が特徴です。デベロッパーは、実際のビジネス ロジックを構築するのではなく、gRPC エラーのデバッグ、フィールドの互換性の検索、リンターの問題の修正など、API との格闘に多くの時間を費やしています。
アシスタント バージョン 4.0.0 では、テストで裏付けられた専門的なスキルと組み込みのスラッシュ コマンドを活用したモジュール型プラグイン アーキテクチャを導入することで、この問題を解決しています。自動化されたエキスパート ミドルウェアとして機能し、バージョンの検証、スキーマの検出、コードのリンティングなどの作業を処理します。これにより、デベロッパーは構文ではなく意図のレベルで操作できます。
推測ではなく、公式スキーマに基づいている
標準の大規模言語モデルは、一般的なトレーニング データに依存しているため、ドメイン固有の API の処理に苦労することがよくあります。新しい API バージョンがリリースされると、トレーニング データはすぐに古くなります。
Google Ads API Developer Assistant は、組み込みの Google Ads API アーキテクチャ ルールと、動的なローカル Protobuf スキーマ検査を組み合わせることで、この問題を解決します。
- 決定的検証: アシスタントは、複数の往復にわたる LLM の推測を繰り返すのではなく、ローカルの 4 ステップのパイプラインを実行して、フィールドの互換性、リソースの関係、ゼロインプレッション ルール、日付のセグメンテーションを 1 つのステップで検証します。
- バージョンに正確なスキーマ検索: アクティブな API バージョンの公式 API スキーマから Protobuf リソース定義、データ型、列挙値を直接検査し、リモート メタデータ クエリの繰り返しを回避します。
- 公式クライアント ライブラリのグラウンディング: コード生成は、Python、Java、PHP、.NET、Ruby の公式 Google 広告クライアント ライブラリに直接基づいています。
例: 専門的な研究と診断を行うラボ
このアシスタントは、外科医にとってのハイテク研究室のようなものです。
- 外科医（デベロッパー）: どのような手術を行う必要があるかを把握しています（例: 「P-MAX のパフォーマンスを分析する必要がある」）。
- ラボ機器（API）: 手術に必要な強力なツールですが、高度なものであり、正確な調整が必要です。
- ラボアシスタント（このツール）: 患者に触れる前に、ラボアシスタントは、専門的なスキルと組み込みコマンドを使用して、次のことを行います。
- マニュアルを確認する: 最新の API プロトコルを自動的に検証し、リソース構造をオンザフライで検査します（
inspect_object//inspect-object）。 - ツールを事前テストする: ライブ API 検証（
validate_gaql//validate-gaql）を使用してクエリで決定論的ドライランを実行し、エラーが発生する前に検出します。 - 環境をクリーンアップする: 厳格なリンター パイプライン（
ruffリンティング）を使用してコードをフォーマットしてクリーンアップし、システムエラーが発生しないようにします。 - バイタルのモニタリング: API 例外を監視し、オフライン コンバージョン（
troubleshoot_conversions//troubleshoot-conversions）などの複雑なオペレーションに対して高度な診断ワークフローを実行します。 - コンセプトの説明: 複雑なコンセプトを日常的な言葉で説明し、現実世界の例え話を使用します（
/explain、/step-by-step、/assistant-tutorial）。
- マニュアルを確認する: 最新の API プロトコルを自動的に検証し、リソース構造をオンザフライで検査します（
相互接続性: 「安全第一」の橋
アシスタントは、制御契約（AGENTS.md / CLAUDE.md）に則って管理されるプロジェクト内の 4 つの異なる「世界」を結ぶブリッジとして機能します。
- ユーザー コンテキスト: ユーザーのハイレベルな目標を理解し、技術的な戦略に変換します。
- ローカル ワークスペース: プロジェクト ディレクトリに「目と手」があります。既存のコードを読み取り、後で使用するために新しいコードを書き込むことができます。厳密な分離が維持されます。
- Google Ads API: ライブ API に接続して、読み取り専用のレポートを実行し、アカウントに対してクエリをテストします。フィールドを迅速に検証するため、ローカルの Protobuf スキーマを直接検査します。
- 安全ゲートキーパー: 厳格なプロトコルに従うようにハードワイヤードされています。lint 処理されていないスクリプトは実行できず、プログラムによる検証チェックに合格していないクエリは送信できません。
アシスタントの動作
簡単に言えば、アシスタントは安全を確保し、作業を加速させるためのものです。
- ミスを防ぐ: コードとクエリをアクティブな API スキーマに対して実行前に検証し、構文エラーと互換性エラーがライブ API に到達する前に停止します。
- 地図を認識する: Google Ads API の地理情報（データがどこに存在し、どのように効率的にクエリするか）を理解します。
- 退屈な作業を自動化する: ボイラープレート クライアント ライブラリ コードの作成、レポートのターミナル テーブルへの整形、クライアント ライブラリの配管処理を行います。
- 複雑なワークフローのトラブルシューティング: オフライン コンバージョンのアップロードに関する詳細分析を実行し、MCC アカウントの階層を解決します。また、P-MAX のリスティング フィルタや URL の除外など、複雑なキャンペーン構造を構成します。
- ライブのアドホック レポートをストリーミングする: パフォーマンス データを平易な英語でリクエストすると、アシスタントが GAQL クエリを作成、検証し、アカウントに対して直接実行します。フォーマットされた結果はターミナルにストリーミングされるか、CSV にエクスポートされます。
- 最新の状態を維持する: アクティブな API バージョンのローカル Protobuf スキーマとドキュメントを検査することで、非推奨のフィールドや古いルールを回避できます。
Google Ads API Developer Assistant は、「デベロッパーと API」の戦いを「デベロッパー + AI」のコラボレーションに変え、安全で、慣用的な、アーキテクチャ的に健全なコードを生成します。
アーキテクチャとパフォーマンス（v4.0.0）
バージョン 4.0.0 では、アシスタントがスタンドアロン プロジェクトの設定から、最新のグローバル プラグイン アーキテクチャに移行します。
- デーモンのオーバーヘッドがゼロ: スキルと診断コマンドは、呼び出されたときにのみ軽量の子プロセスとして一時的に実行され、アイドル状態のときはシステム リソースの使用量がゼロになります。
- プログレッシブ コンテキスト開示: ルールとスキーマは、アクティブなタスクに関連する場合にのみオンデマンドで読み込まれるため、トークン消費量とプロンプト レイテンシが大幅に削減されます。
- ディスク I/O の削減: プラグイン ツリーから不要な SDK ファイルを削除することで、IDE インデクサ、リンター、ファイル ウォッチャーが数万もの未使用ファイルをスキャンすることを防ぎます。
- マルチプラットフォーム ホストのサポート: Linux、macOS、Windows で統合されたインストール スクリプトを使用して、Google Antigravity 環境と Claude Code 環境間でシームレスに動作します。
次のステップ
- Google Ads API Developer Assistant をインストールして構成する
- Google Ads API エージェントのスキルについて
- Google Ads API MCP サーバーの詳細