前提条件
Firebase を追加する前に、次の準備をしてください。
Google Ads API へのアクセス:
- Google Ads API 開発者トークン。
- デベロッパー トークン、OAuth 2.0 認証情報、顧客 ID で構成された Google 広告構成ファイル。通常はホーム ディレクトリにあります。クライアント ライブラリの構成ガイドをご覧ください。
- Google Ads API のコンセプトと認証に関する知識。
ソフトウェア:
- Python 3.10 以降。Python はデフォルトの言語であるため、インストールしてパスに含める必要があります。
- gemini-cli がインストールされている。
- jq（コマンドライン JSON プロセッサ）。インストール スクリプトは、これが存在しない場合にインストールを試みます。
リポジトリ:
- GitHub の
google-ads-api-developer-assistantリポジトリのローカルクローン:
- GitHub の
始める
プロジェクト ディレクトリに移動します。
cd <full path>/google-ads-api-developer-assistant設定スクリプトを実行する: このスクリプトは、アシスタントの
GEMINI.mdコンテキスト ファイルと必要なツールを使用するように gemini-cli を構成します。./install.shWindows を使用している場合は、
setup.ps1PowerShell スクリプトを実行します。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 と入力すると、デフォルトの言語が Python、Ruby、PHP の場合、スクリプトはアシスタントのコンテキストで実行されます。セキュリティ ポリシーにより、コンパイルされた言語は実行されません。
CSV エクスポート: API 呼び出しからの表形式の結果を CSV ファイルに保存します。
- 「結果を CSV ファイルに保存します。」ファイルは
saved_csv/ディレクトリに保存されます。
- 「結果を CSV ファイルに保存します。」ファイルは
トラブルシューティングのサポート: エラー メッセージや予期しない API の動作に関するサポートを受けます。
- 「'AuthenticationError.OAUTH_TOKEN_INVALID' というエラーが表示されました。どうすればよいですか？」
- 「クエリの結果が表示されないのはなぜですか？」
サンプル ユースケース
- レポート:
- 「顧客 12345678 の先月の費用上位 5 個のキーワードを取得して。」
- アカウントの構成:
- 「すべてのキャンペーン名とその ID を一覧表示します。」
- トラブルシューティング:
- 「100 件のコンバージョンをアップロードしたのに、UI には 78 件しか表示されません。API を使用してデバッグするにはどうすればよいですか？」
- 学習:
- 「共有セットとは何かを説明して」
- コード生成:
- 「company name の P-MAX キャンペーンを作成するコードを記述してください。」
コミュニティとサポート
- GitHub の問題: バグの報告、機能の提案、ヘルプの依頼は、リポジトリの [Issues] タブで行います。
- Discord: 広告と測定に関する Google コミュニティの Discord サーバーの
#ads-api-ai-toolsチャンネルでディスカッションに参加してください。 - フィードバック: アンケート フォームからフィードバックをお寄せください。
コード提供に関するガイドライン
コントリビューションをお待ちしています。ガイドラインについては、GitHub リポジトリの CONTRIBUTING.md ファイルをご覧ください。