2025 年 12 月 10 日（水曜日）
Google Ads API Developer Assistant のリリースを発表いたします。これは、Google Ads API ワークフローを効率化するために設計された、Gemini CLI の強力な拡張機能です。このツールを使用すると、日常的な言語で Google Ads API を操作できるため、情報の取得、コードの生成、ターミナルでの直接的なデータの取得がこれまで以上に簡単になります。
Google Ads API の初心者でも、経験豊富なデベロッパーでも、このアシスタントは作業の効率化に役立ちます。
何ができるか
Google Ads API Developer Assistant（v1.0）は、いくつかの重要な機能で Gemini CLI を強化します。
- 自然言語による Q&A: Google Ads API について質問がある場合は、お気軽にお問い合わせください。
- 「利用可能なキャンペーン タイプを教えてください」
- 「P-MAX キャンペーンのレポートについて教えてください。」
- 「GAQL で日付でフィルタするにはどうすればよいですか？」
- 自然言語からコードを生成: 必要なデータを記述すると、アシスタントが Google 広告クエリ言語（GAQL）と実行可能な Python コードを生成します。このとき、
google-ads-pythonクライアント ライブラリをコンテキストとして使用するため、コードはベスト プラクティスに準拠したものになります。- 「過去 30 日間でコンバージョン数が最も多かったキャンペーンを表示して。」
- 「お客様 '123-456-7890' のすべての広告グループを取得する」
- 「すべてのキャンペーンで不承認となった広告を検索する」
- 生成されたコードは、
saved_code/ディレクトリに自動的に保存されます。
- API の直接実行: 生成された Python スクリプトをコマンドラインから直接実行します。アシスタントは読み取り専用の API 呼び出しを実行し、結果を表示します。多くの場合、結果はターミナル内でテーブルとして整然とフォーマットされます。
- CSV 形式でのエクスポート: データを保存する必要がある場合は、API 呼び出しの結果を表形式で CSV ファイルに簡単にエクスポートできます。次のように尋ねます。
- 「結果を CSV ファイルに保存する」
- ファイルは
saved_csv/ディレクトリに保存されます。
その仕組みとは
この拡張機能は、GEMINI.md ファイルのコンテキストと .gemini/settings.json 内の設定を使用する Gemini CLI の機能を活用します。ローカルの google-ads-python ライブラリ クローンとサンプル ディレクトリへのパスを使用してアシスタントを構成することで、関連性の高い正確なコードを生成できます。
スタートガイド
開始するにあたって必要なものは次のとおりです。
前提条件:
- Google Ads API のコンセプトと認証に関する知識。
- Google Ads API 開発者トークン。
- ホーム ディレクトリに構成済みの
google-ads.yaml認証情報ファイル。 - Python 3.10 以降。
- Gemini CLI がインストールされている。
google-ads-pythonクライアント ライブラリのローカルコピー。（設定スクリプトでクローンを作成できます）。
詳細な設定手順と例については、GitHub リポジトリの README ファイルをご覧ください。
アクセス方法
Google Ads API Developer Assistant は GitHub で入手できます。
コミュニティとサポート
ぜひお試しください。こちらのアンケートから、貴重なご意見をお寄せください。Discord の #ads-api-ai-tools チャンネルでディスカッションにご参加ください。
バグの報告、機能の提案、サポートのリクエストには、リポジトリの GitHub Issues タブを使用してください。投稿に関するガイドラインについては、CONTRIBUTING.md をご覧ください。
ぜひご活用ください。
ラベル: google-ads-api、 release