アシスタントは汎用的な chatbot ではありません。これは、Google Antigravity と Claude Code エージェント フレームワーク（v4.0.0）上に構築された、AI を活用した広告エンジニアリング専用のミッション コントロール システムです。
全体像: コンプライアンスの高いワークロードの摩擦を解消する
このアシスタントが解決する根本的な問題は、認知過負荷と技術的な労力です。
Google Ads API は、利用可能な API の中で最も強力な API の 1 つですが、最も複雑な API の 1 つでもあります。厳格なバージョン管理、独自のクエリ言語（GAQL）、深くネストされたプロトコル バッファ構造、厳格な安全要件が特徴です。デベロッパーは、実際のビジネス ロジックの構築ではなく、gRPC エラーのデバッグ、フィールドの互換性の検索、リンターの問題の修正に多くの時間を費やしています。
アシスタントは、バージョン 4.0.0 で、専門的なテスト済みのスキルと組み込みのスラッシュ コマンドを搭載したモジュール型プラグイン アーキテクチャを導入することで、この問題を解決しています。自動化されたエキスパート ミドルウェアとして機能し、バージョン検証、スキーマ検出、コードの lint チェックのトイルを処理します。これにより、デベロッパーは構文ではなくインテントのレベルで操作できます。
推測ではなく、公式スキーマに基づく
標準的な大規模言語モデルは、一般のトレーニング データに完全に依存しているため、ドメイン固有の API に対応するのが難しいことがよくあります。新しい API バージョンがリリースされると、トレーニング データはすぐに古くなってしまいます。
Google Ads API デベロッパー アシスタントは、埋め込みの Google Ads API アーキテクチャ ルールと動的なローカル Protobuf スキーマ検査を組み合わせることで、この問題を解決します。
- 決定論的検証: アシスタントは、複数のラウンドトリップにわたる LLM の推測を繰り返すのではなく、ローカルの 4 ステップの検証パイプラインを実行して、フィールドの互換性、リソースの関係、ゼロインプレッション ルール、日付のセグメンテーションを 1 つのステップで検証します。
- バージョンに正確なスキーマ ルックアップ: アクティブな API バージョンの公式 API スキーマから Protobuf リソース定義、データ型、列挙値を直接検査し、リモート メタデータの繰り返しクエリを回避します。
- 公式クライアント ライブラリのグラウンディング: コード生成は、Python、Java、PHP、.NET、Ruby の公式 Google Ads クライアント ライブラリに直接グラウンディングされます。
例: 専門的な研究と診断を行うラボ
アシスタントは、外科医にとってのハイテク研究室のようなものです。
- 外科医（デベロッパー）: どのような手術が必要か正確に把握しています（例: 「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 スキーマを直接検査します。
- 安全性のゲートキーパー: 厳格なプロトコルに従うようにハードワイヤードされています。リント処理されていないスクリプトは実行できず、プログラムによる検証チェックに合格していないクエリは送信できません。
アシスタントの実際の動作
簡単に言うと、アシスタントは保護と加速の役割を果たします。
- 間違いを防ぐ: コードとクエリをアクティブな API スキーマに対して実行前に検証し、構文エラーと互換性エラーがライブ API に到達する前に停止します。
- 地図を認識する: Google Ads API の地理情報（データの保存場所や効率的なクエリ方法など）を理解します。
- 退屈な作業を自動化する: 定型的なクライアント ライブラリ コードを記述し、レポートをクリーンなターミナル テーブルにフォーマットし、クライアント ライブラリの配管を処理します。
- 複雑なワークフローのトラブルシューティング: オフライン コンバージョンのアップロードの詳細分析を実行し、クライアント センター アカウントの階層を解決し、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 サーバーの詳細