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 の中でも特に強力ですが、最も複雑な API の 1 つでもあります。厳格なバージョニング、独自のクエリ言語（GAQL）、深くネストされたプロトコル バッファ構造、厳格な安全要件が特徴です。デベロッパーは、実際のビジネス ロジックを構築するのではなく、gRPC エラーのデバッグ、フィールドの互換性の確認、linter の問題の修正など、API の問題への対応に多くの時間を費やすことがよくあります。
Assistant バージョン 4.0.0 では、テスト済みの専用スキルと組み込みのスラッシュ コマンドを活用したモジュラー プラグイン アーキテクチャを導入することで、この問題を解決しています。自動化されたエキスパート ミドルウェアとして機能し、バージョンの検証、スキーマの検出、コードの lint チェックなどの面倒な作業を処理します。これにより、デベロッパーは構文ではなく、意図のレベルで操作できます。
推測ではなく、公式スキーマに基づいている
標準的な大規模言語モデルは、一般的なトレーニング データに依存しているため、ドメイン固有の API の処理に苦労することがよくあります。このデータは、新しい API バージョンがリリースされるとすぐに古くなります。
Google Ads API Developer Assistant は、組み込みの Google Ads API アーキテクチャ ルールと、動的なローカル Protobuf スキーマ検査を組み合わせることで、この問題を解決します。
- 決定的検証: アシスタントは、複数の往復で LLM の推測を繰り返すのではなく、ローカルの 4 ステップ検証パイプラインを実行して、フィールドの互換性、リソースの関係、インプレッション ゼロのルール、日付セグメンテーションを 1 つのステップで検証します。
- バージョンに正確なスキーマ検索: Protobuf リソース定義、データ型、列挙型値を、アクティブな API バージョンの公式 API スキーマから直接検査し、リモート メタデータ クエリの繰り返しを回避します。
- 公式クライアント ライブラリのグラウンディング: コード生成は、Python、Java、PHP、.NET、Ruby の公式 Google 広告クライアント ライブラリに直接グラウンディングされます。
例え: 専門的な研究および診断ラボ
このアシスタントは、外科医にとってのハイテク研究室のようなものです。
- 外科医（デベロッパー）: どのような手術を行う必要があるかを把握しています（例: 「P-MAX のパフォーマンスを分析する必要がある」）。
- ラボ機器（API）: 手術に必要な強力なツールですが、高度なものであり、正確な調整が必要です。
- ラボアシスタント（このツール）: 患者に触れる前に、ラボアシスタントは、専門的なスキルと組み込みコマンドを使用して、次のことを行います。
- マニュアルを確認する: 最新の API プロトコルを自動的に検証し、リソース構造をオンザフライで検査します（
inspect_object//inspect-object）。 - ツールを事前にテストする: ライブ API 検証（
validate_gaql//validate-gaql）を使用してクエリに対して決定論的なドライランを実行し、エラーが発生する前にエラーをキャッチします。 - 環境を滅菌する: 厳格な linter パイプライン（
rufflint チェック）を使用してコードをフォーマットしてクリーンアップし、システムエラーが発生しないようにします。 - バイタルのモニタリング: API 例外を監視し、オフライン コンバージョン（
troubleshoot_conversions//troubleshoot-conversions）などの複雑なオペレーションに対して高度な診断ワークフローを実行します。 - コンセプトの説明: 複雑なコンセプトを、日常的な言葉と現実世界の例えを使って説明します（
/explain、/step-by-step、/assistant-tutorial）。
- マニュアルを確認する: 最新の API プロトコルを自動的に検証し、リソース構造をオンザフライで検査します（
相互接続性: 「安全性第一」のブリッジ
アシスタントは、プロジェクト内の 4 つの異なる「世界」をつなぐブリッジとして機能します。これらの世界は、制御コントラクト（AGENTS.md / CLAUDE.md）に則って管理されます。
- ユーザー コンテキスト: ユーザーのハイレベルな目標を理解し、技術的な戦略に変換します。
- ローカル ワークスペース: プロジェクト ディレクトリに「目と手」があります。既存のコードを読み取り、後で使用するために新しいコードを書き込むことができます。また、厳格な分離を維持します。
- Google Ads API: ライブ API に接続して、読み取り専用レポートを実行し、アカウントに対してクエリをテストします。フィールドを迅速に検証するために、ローカルの Protobuf スキーマを直接検査します。
- 安全性のゲートキーパー: 厳格なプロトコルに従うようにハードワイヤードされています。lint されていないスクリプトは実行できず、プログラムによる検証チェックに合格していないクエリは送信できません。
アシスタントの動作
簡単に言えば、アシスタントは安全を確保し、作業を加速させるためのものです。
- ミスを防ぐ: 実行前にアクティブな 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 サーバーの詳細