Google Ads API Developer Assistant v3.0.0 のご紹介

2026 年 6 月 10 日（水曜日）

このたび、Google Ads API Developer Assistant の v3.0.0 がリリースされました。このメジャー リリースは、アシスタントの進化における重要なマイルストーンであり、アーキテクチャのモダナイゼーション、信頼性の向上、よりモジュラーな設計に重点を置いています。

今回のリリースでは、アシスタントを Google Antigravity エージェント フレームワークに移行し、スキルベースのアーキテクチャに移行します。これらの変更により、アシスタントの堅牢性が向上し、メンテナンスが容易になり、トークンの使用量が削減されます。

v3.0.0 の新機能

1. Antigravity フレームワークを活用

Google Ads API Developer Assistant が gemini-cli から Antigravity エージェント フレームワーク（v3.0.0）に移行されました。この基盤となるフレームワークのアップグレードにより、より構造化された信頼性の高い実行環境が提供されます。これに伴い、プロジェクトのディレクトリとファイル構造が更新され、Antigravity に完全に対応するようになりました。

gemini-cli のサポートは、2026 年 6 月 18 日に終了します。詳しくは、こちらの Google ブログのお知らせをご覧ください。

2. モジュール式のスキルベースのアーキテクチャ

アシスタントのコア機能はスキルに移行されました。コンテキスト ファイル内の広範で構造化されていない指示に依存するのではなく、必要に応じて、テストで裏付けられた専門的なツール ディレクトリ（スキル）を動的に読み込むようになりました。これにより、「ハルシネーション」が大幅に削減され、正確で検証済みの手順を使用してタスクが実行されます。

このモジュラー移行における主な更新内容は次のとおりです。

  • GAQL の検証（validate_gaql）: 専用のスキルに移動しました。日付セグメント、click_view の 1 日フィルタ、change_status の境界に対する静的クエリチェックが強化されました。
  • コンバージョンのトラブルシューティング（troubleshoot_conversions）: 以前の conversions_support_package に代わるものです。コンバージョンのトラブルシューティングとアップロードの概要スクリプト、テストをすべて 1 つのまとまったスキル ディレクトリに統合します。
  • 構造化コマンド（explain と step_by_step）: スキルに変換され、説明に一貫性のある構造化されたレイアウトが適用されます。
  • 新しいアカウント マッピング（get_cids_under_mcc）: クライアント センター（MCC）アカウント配下のすべての子アカウントを取得する新しいスキル。
  • 新しいオブジェクト検査（inspect_object）: Protobuf メッセージと列挙型を動的に検索する新しいスキル。アシスタントが常に正しい構造を使用できるようにします。
  • 新しい P-MAX リスティング フィルタ（pmax_listing_filter）: P-MAX キャンペーンのリスティング グループのウェブページ除外ツリーの変更を標準化する新しいスキル。

3. 一貫性と厳格性の強化

高品質なコード生成とクエリ検証を確実に行うため、より厳格なルールと要件を導入しました。

  • 明示的な API バージョニング: get_cids_under_mcc、validate_gaql、troubleshoot_conversions などの重要なスキルで、明示的な api_version 引数が必要になり、曖昧さが排除されました。
  • 厳格な GAQL ルール:
    • GAQL クエリで SQL 集計関数（SUM、COUNT、AVG など）を使用できないようにするルールを AGENTS.md に追加しました。これらの関数はサポートされていません。
    • アシスタントが最新のドキュメントを使用できるように、現在の API バージョンについて、まず Google Ads API デベロッパー サイトのリリースノートを確認するルールを追加しました。
    • 構成の合理化: AGENTS.md が合理化され、初期コンテキスト ウィンドウが小さくなりました。プログラマティック スキルを優先するため、重複するコンバージョンのドキュメントを削除しました。

4. デベロッパー エクスペリエンス（DX）の改善

開発ループをより迅速かつスムーズにするために、いくつかの改善を加えました。

  • 永続的な仮想環境（.venv）: セッションの終了時に仮想環境が削除されなくなりました。起動時に、アシスタントはシステムの Python バージョンを確認します。新しい Python バージョンが利用可能な場合にのみ、.venv を再ビルドします。
  • スマートな API バージョン キャッシュ: アシスタントは、現在の Google Ads API バージョンを 19 時間の TTL でキャッシュするようになりました。これにより、冗長なネットワーク チェックが回避され、起動時間が短縮されます。
  • 永続ログによるデバッグの改善: ログ メッセージに日時スタンプが含まれるようになりました。ログファイルは .agents/ ディレクトリに書き込まれ、実行ごとにリセットされなくなりました。これにより、トラブルシューティング用の履歴が保持されます。

アップグレードするメリット

v3.0.0 へのアップグレードは、主に信頼性と構造に関するものです。Antigravity フレームワークに移行し、機能をスキルにモジュール化することで、アシスタントの予測可能性とリソース効率が向上しました。

起動の高速化、GAQL 検証の信頼性の向上、トラブルシューティングの堅牢性の向上をご希望の場合は、v3.0.0 へのアップグレードをおすすめします。

使ってみる

初回インストール

  1. Antigravity CLI をインストールする: https://antigravity.google/ の手順に沿って操作します。
  2. アシスタントのクローンを作成する: 
    git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  3. インストール スクリプトを実行する:
    • Linux / macOS: ./install.sh を実行します（デフォルトは Python サポートです。他の言語には --php や --ruby などのフラグを使用します）。
    • Windows: PowerShell を開き、.\install.ps1 を実行します。

v2.x からのアップグレード

  1. カスタムコードまたはデータを saved/ からプロジェクト ディレクトリ外の安全な場所にコピーします。
  2. アシスタントのローカル クローンを削除します。
  3. リポジトリのクローンを作成します。
git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  1. インストール スクリプト（install.sh または install.ps1）を実行して、新しい Antigravity 環境を初期化します。

Bob Hancock、Google Ads API チーム

ラベル: google-ads-api、 release