Google Ads API Developer Assistant をインストールして使用する

前提条件

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

  1. Google Ads API へのアクセス権:

  2. ソフトウェア:

    • Python 3.10 以降。Python はデフォルトの言語であるため、インストールしてパスに含める必要があります。
    • gemini-cli がインストールされていること。
    • jq（コマンドライン JSON プロセッサ）。 インストール スクリプトは、このプロセッサがない場合にインストールを試みます。

  3. リポジトリ:

始める

  1. プロジェクト ディレクトリに移動します。

    cd <full path>/google-ads-api-developer-assistant

  2. セットアップ スクリプトを実行します。 このスクリプトは、アシスタントの GEMINI.md コンテキスト ファイルと必要なツールを使用するように gemini-cli を構成します。

    ./install.sh

    Windows を使用している場合は、setup.ps1 PowerShell スクリプトを実行します。

  3. gemini-cli を起動します。

    gemini

  4. アシスタントとやり取りします。 自然言語で質問やコマンドを入力できるようになりました。

主な機能

  • 自然言語による質問と回答: 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>

デフォルトの言語が Python、Ruby、PHP の場合は、「run」と入力すると、スクリプトがアシスタントのコンテキストで実行されます。コンパイル済み言語は、 セキュリティ ポリシーにより実行されません。

  • CSV エクスポート: API 呼び出しからの表形式の結果を CSV ファイルに保存します。

    • 「結果を CSV ファイルに保存してください。」 ファイルは saved_csv/ ディレクトリに保存されます。

  • トラブルシューティングのサポート: エラー メッセージや予期しない API の動作についてサポートを受けられます。

    • 「「AuthenticationError.OAUTH_TOKEN_INVALID」というエラーが表示されました。どうすればよいですか？」
    • 「クエリの結果が表示されないのはなぜですか？」

  • 追加のコンテキスト: コンテキストとしてコードベースを追加します。

    • v2.3.0 以降では、context_dir フラグを使用してプロジェクト ファイルを含めます: ./update.sh --context_dir /path/to/your/codebase これにより、 アシスタントはレスポンスを作成する際にアプリケーション ロジックを推論に含めることができます。
    • この機能により、アシスタントは選択した言語で保存されたコード例を生成できるため、公式クライアント ライブラリが利用できない場合でもサポートを提供できます。
    • コード出力をリクエストする前に、アシスタントに write saved code examples in <language of your application>と伝えます。

サンプル ユースケース

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

コミュニティとサポート

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

投稿に関するガイドライン

投稿をお待ちしております。ガイドラインについては、GitHub リポジトリの CONTRIBUTING.md ファイルをご覧ください。

前へ
Google Ads API デベロッパー アシスタントとは何ですか？