Google Ads API Developer Assistant

Google Ads API Developer Assistant は、Google Ads API ワークフローを高速化するために設計された Gemini CLI の強力な拡張機能です。アシスタントを使用すると、自然言語を使用して Google Ads API を操作できるため、ターミナル内で直接質問したり、コードを生成したり、データを取得したり、問題をトラブルシューティングしたりすることが容易になります。

利点

生産性の向上: ドキュメントの検索やボイラープレートコードの作成にかかる時間を短縮できます。
複雑なタスクを簡素化する: 簡単な英語のプロンプトから Google 広告クエリ言語（GAQL）とクライアントライブラリコードを生成します。
API を学ぶ: API のコンセプトを理解し、自然言語リクエストが実行可能なコードに変換される仕組みを確認します。
インタラクティブなデバッグ: エラーの理解とトラブルシューティングの手順に関するガイダンスを確認できます。
効率化されたワークフロー: 開発とテストのループをコマンドライン内に維持します。

前提条件

Firebase を追加する前に、次の準備をしてください。

Google Ads API へのアクセス:
- Google Ads API 開発者トークン。
- デベロッパートークン、OAuth 2.0 認証情報、顧客 ID で構成された google-ads.yaml ファイル。通常はホームディレクトリにあります。クライアントライブラリの構成ガイドをご覧ください。
- Google Ads API のコンセプトと認証に関する知識。
ソフトウェア:
- Python 3.10 以降。Python はデフォルトの言語であるため、インストールしてパスに含める必要があります。
- Gemini CLI がインストールされている。
- jq（コマンドライン JSON プロセッサ）。設定スクリプトは、これが存在しない場合にインストールを試みます。
リポジトリ:
- GitHub の google-ads-api-developer-assistant リポジトリのローカルクローン:

始める

プロジェクトディレクトリに移動します。
```
cd <full path>/google-ads-api-developer-assistant
```
設定スクリプトを実行する: このスクリプトは、アシスタントの GEMINI.md コンテキストファイルと必要なツールを使用するように Gemini CLI を構成します。
```
./setup.sh
```
Windows を使用している場合は、setup.ps1 PowerShell スクリプトを実行します。
Gemini CLI を起動します。
```
gemini
```
アシスタントとやり取りする: 自然言語で質問したり、コマンドを入力したりできるようになりました。

主な機能

自然言語の Q&A: Google Ads API の機能、ベストプラクティス、特定のリソースについて質問できます。
- 「提供されているキャンペーンタイプの組み合わせは、次のうちどれですか？」
- 「GAQL で日付でフィルタするにはどうすればよいですか？」
- 「click_view と impression_view の違いを説明してください。」
コード生成: GAQL クエリと実行可能な Python コードスニペットを生成します。
- 「過去 30 日間でコンバージョン数が最も多いキャンペーンを表示して。」
- 「キャンペーン ID 12345 の有効な広告グループ名をすべて取得します。」
- 「すべてのキャンペーンで不承認の広告を見つける。」 生成されたコードは saved_code/ ディレクトリに保存されます。
API の直接実行: 生成された読み取り専用の Python スクリプトを Gemini CLI から直接実行し、ターミナルでフォーマットされた結果を表示します。アシスタントがコードを生成すると、画面に次のプロンプトが表示されます。

To run this script, you will need to replace YOUR_CUSTOMER_ID with your actual
Google Ads customer ID and execute the following command in
your shell: <command>

run と入力すると、アシスタントのコンテキストでスクリプトが実行されます。

CSV エクスポート: API 呼び出しの表形式の結果を CSV ファイルに保存します。
- 「結果を CSV ファイルに保存します。」ファイルは saved_csv/ ディレクトリに保存されます。
トラブルシューティングのサポート: エラーメッセージや予期しない API の動作に関するサポートを受けます。
- 「'AuthenticationError.OAUTH_TOKEN_INVALID' というエラーが表示されました。どうすればよいですか？」
- 「クエリの結果が表示されないのはなぜですか？」

サンプルユースケース

レポート:
- 「顧客 12345678 の先月の費用上位 5 個のキーワードを取得して。」
アカウントの構成:
- 「すべてのキャンペーン名とその ID を一覧表示します。」
トラブルシューティング:
- 「100 件のコンバージョンをアップロードしたのに、UI には 78 件しか表示されません。API を使用してデバッグするにはどうすればよいですか？」
学習:
- 「API を使用して P-MAX キャンペーンを作成する方法を教えてください。」

コミュニティとサポート

GitHub の問題: バグの報告、機能の提案、ヘルプの依頼は、リポジトリの [Issues] タブで行います。
Discord: Google 広告と測定に関するコミュニティの Discord サーバーの #ads-api-ai-tools チャンネルでディスカッションにご参加ください。
フィードバック: アンケートフォームからフィードバックをお寄せください。

コード提供に関するガイドライン

コントリビューションはいつでも大歓迎です。ガイドラインについては、GitHub リポジトリの CONTRIBUTING.md ファイルをご覧ください。