Google Ads API Developer Assistant v2.0 のご紹介

2026 年 2 月 26 日（木曜日）

この大規模なアップデートにより、アシスタントは、強力なコード生成ツールから、Google 広告デベロッパー向けのプロアクティブなトラブルシューティングと自動化のパートナーへと生まれ変わります。v1.6.0 のリリース以降、Google は皆様からのフィードバックに耳を傾け、API 開発で最も困難な部分である診断、整合性、設定に注力してきました。

v2.0 の新機能

1. 設置とメンテナンスがより簡単に

多言語開発環境の設定は、面倒な作業ではありません。

  • 1 つのコマンドで設定: install.sh または install.ps1 で新しい --install-deps フラグを使用すると、pip、composer、bundler の依存関係を一度に処理できます。
  • 統合されたディレクトリ構造: 生成されたすべてのコード、CSV エクスポート、診断レポートが、出力タイプごとにサブディレクトリを持つ単一の saved/ ディレクトリに整理されるようになりました。
  • 1 つのコマンドで更新: API とクライアント ライブラリの新しいバージョンがリリースされたら、update.sh を実行して最新バージョンを使用する必要があります。update.sh を使用して、コンテキストにクライアント ライブラリを追加することもできます。

2. エージェント コンバージョンのトラブルシューティング

オフライン コンバージョン トラッキングは、Google Ads API の最も強力な機能の一つですが、複雑でもあります。コンバージョンがアトリビューションされなかった理由をデバッグするには、手動で時間のかかるプロセスが必要になることがあります。

v2.0 では、専用のコンバージョンのトラブルシューティングと診断スイートが導入されました。

  • 新しいスクリプト: api_examples/collect_conversions_troubleshooting_data.py
  • 新しいコマンド: /conversions_support_data

このスクリプトは、コンバージョンのトラブルシューティング用の標準レポートを実行し、アシスタントが問題をトラブルシューティングするためのコンテキストを提供します。

このコマンドは、アシスタントがコンバージョンの問題を分析して解決を試みた後に最も役立ちます。診断できず、サポートに問い合わせる必要がある場合は、このコマンドを使用すると、お客様の設定、コンバージョン アクション、アップロードの概要が分析され、すでに実施された分析に基づいて構造化された診断レポートが生成されます。また、「異常」な状態や高い障害率を自動的に特定するため、ログを調べる時間を節約できます。結果はテキスト ファイルに保存されます。サポート リクエストを提出する必要がある場合は、このファイルを添付できます。

3. 最新の API（v23）向けに構築

バージョン 2.0 は、Google Ads API v23 を完全にサポートしています。すべてのインタラクティブな例が更新され、アシスタントの内部コンテキストが最新のリソースとフィールドに最適化されました。これにより、生成されるコードは本番環境に対応したものになります。

4. セッション フックによるシームレスな自動化

SessionStart フックと SessionEnd フックを追加して、ワークフローを完全に摩擦のないものにしました。

  • 自動構成: セッションの開始時に、アシスタントが $HOME ディレクトリ内の構成ファイルを自動的に見つけられるようになりました。プロジェクト ディレクトリのサブディレクトリ config にコピーされます。Python は、Gemini で API をクエリする際に推奨される言語です。そのため、別の言語を使用している場合は、構成ファイルを読み取り、クエリ用に一時的な google-ads.yaml を config に作成しますが、引き続き、選択した言語のコードで応答します。
  • 自動クリーンアップ: 終了時に一時的な構成が安全にワイプされるため、ワークスペースをクリーンに保ち、認証情報を安全に保護できます。

5. よりスマートな GAQL 検証

複雑な GAQL クエリの作成がこれまで以上に簡単になりました。GEMINI.md と conversions/GEMINI.md を更新し、最新の API エッジケースに対応する厳格な検証ルールを導入しました。これには、日付セグメントと有限範囲要件の処理の改善が含まれます。アシスタントは、クエリを実行する前にロジックエラーを検出するようになりました。

6. スキル

スキルは、ミニプラグインまたは「動作のブループリント」と考えてください。一般的なコンテキスト（GEMINI.md ファイルなど）は背景情報を提供しますが、スキルは、この拡張機能の現在のバージョンを取得するなどの複雑な手続き型タスクを実行する必要がある場合にのみ、AI の脳に「読み込まれ」ます。スキルを直接実行することはありません。Gemini は、必要なときに判断します。

まだ試験運用版の機能ですが、セッションの初期化とクリーンアップにフックを使用することを補完するために、このリリースに 1 つ含まれています。

アップグレードする理由

v1.6.0 から v2.0.0 への移行は、単なる新機能の追加ではなく、信頼性の向上を意味します。v2.0 では、API に関する深い知識と自動診断ツールを統合することで、API 統合の遅延の原因となることが多い「試行錯誤」のループを削減します。

コンバージョン アップロードのデバッグでも、複雑なレポート パイプラインの構築でも、v2.0 のツールを使用すれば、より迅速かつ確実に作業を進めることができます。

スタートガイド

初回インストール

以前のバージョンからのアップグレード

  • saved_code/ と saved_csv/ からカスタムコードを安全な場所にコピーします。
  • プロジェクト ディレクトリとすべてのサブディレクトリおよびファイルを削除して、Google Ads API Developer Assistant のローカル クローンを削除します。
  • git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  • プロジェクト ディレクトリで install.sh または install.ps1 を実行して、拡張機能とクライアント ライブラリをインストールします。

Bob Hancock、Google Ads API チーム

ラベル: google-ads-api、 release