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

前提条件

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

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

  2. ソフトウェア:

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

  3. リポジトリ:

始める

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

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

    （注: Antigravity シェル統合が有効になっている場合、このディレクトリに入るとアシスタント セッションが自動的に初期化されます）。

  2. インストール スクリプトを実行します。このスクリプトは開発環境を初期化し、必要な Google 広告クライアント ライブラリのクローンを作成します（Python はデフォルトでインストールされます）。

    ./install.sh

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

  3. 認証情報を構成します。google-ads.yaml（または言語に対応するファイル）がホーム ディレクトリに配置されていることを確認します。

  4. アシスタントを操作します。セッションがアクティブになったら、ターミナルで自然言語を使用してアシスタントを直接操作できます。

主な機能

  • 自然言語による質問と回答: Google Ads API の機能、ベスト プラクティス、特定のリソースについて質問できます。

    • 「利用可能なキャンペーン タイプは何ですか？」
    • 「GAQL で日付でフィルタするにはどうすればよいですか？」
    • 「click_view と impression_view の違いを説明してください。」

  • コード生成: GAQL クエリと実行可能な Python コード スニペットを生成します。

    • 「過去 30 日間でコンバージョン数が最も多いキャンペーンを表示してください。」
    • 「キャンペーン ID 12345 の有効な広告グループ名をすべて取得してください。」
    • 「すべてのキャンペーンで不承認の広告を見つけてください。」 生成されたコードは ruff を使用して自動的にリントされ、saved/code/ ディレクトリに保存されます。

  • API の直接実行: 生成された読み取り専用の Python スクリプトを、隔離された仮想環境（.venv）内で直接実行し、フォーマットされた結果をターミナルに表形式で表示します。

    • アシスタントに「コードを実行」または「スクリプトを実行」と指示するだけです。
    • 安全のため、変更オペレーション（作成、更新、削除）は生成されますが、実行されることはありません 。

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

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

  • 高度な診断とトラブルシューティング: エラー メッセージ、予期しない API の動作、オフライン コンバージョンの問題についてサポートを受けられます。

    • 「クエリの結果が表示されないのはなぜですか？」
    • 「顧客 123-456-7890 のコンバージョンをトラブルシューティングしてください。」（saved/data/ に詳細な診断レポートが生成されます）。

  • 追加のコンテキスト: コンテキスト用に独自のコードベースまたはカスタム ライブラリを追加します。

    • update.sh スクリプトを --context_path オプションと共に使用して、プロジェクト ファイルを登録します: none ./update.sh --context_path /path/to/your/codebase
    • これにより、アシスタントは、レスポンスの作成時や任意の言語でのコード生成時に、アプリケーション ロジックを推論に含めることができます。

サンプル ユースケース

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

コミュニティとサポート

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

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

前へ
Google Ads API デベロッパー アシスタントとは