Claude や ChatGPT で Google Ads の GAQL クエリを実行するには、Google Ads アカウントを PaidSync.ai に接続し、アシスタントに GAQL クエリを実行させます。アカウントのほぼすべてのリソースを読み取れます。GAQL は Google のクエリ言語です。このツールは読み取り専用なので、クエリで何かが変更されることはありません。
どのツールが作業をするか
GAQL は、Google Ads のレポートの基盤となるクエリ言語です。既成のレポートが合わないときは、Claude がクエリを書いて実行できます。
run_gaql_queryは任意の GAQL クエリを実行する読み取り専用ツールです。キャンペーン、広告グループ、広告、キーワード、アセット、オーディエンス、入札戦略、実験、請求書、変更イベントなど、100 以上のリソースをクエリできます。list_accountsは、クエリできる Google Ads アカウントを一覧表示します。
run_gaql_query と list_accounts はアカウントを読み取るだけです。
ワークフローの構成
| ツール | 主な機能 |
|---|---|
| run_gaql_query | 説明したクエリを実行します |
| list_accounts | 実行できるアカウントを表示します |
クエリは SELECT、FROM、WHERE、ORDER BY、LIMIT を使い、たとえば SELECT campaign.id, campaign.name FROM campaign のように書きます。自分で書く必要はありません。欲しい表を説明し、アシスタントに実行したクエリを表示してもらえば、再利用できます。
Claude で Google Ads の GAQL クエリを実行する 5 ステップ
これらの手順では Claude を使ってGAQL クエリを実行します。PaidSync.ai は ChatGPT でも動作し、プロンプトは同じです。
Google Ads を PaidSync.ai に接続する
paidsync.ai から始めて、Google 自身のサインイン画面で Google Ads を連携します。デベロッパートークンも Google Cloud プロジェクトも不要です。選ぶログインは、GAQL クエリを実行するアカウントにアクセスできるものにしてください。
PaidSync.ai を Claude に追加
Claude のコネクタディレクトリを開き、PaidSync.ai を追加してサインインします。「Google Ads アカウントを一覧表示して」と依頼し、GAQL クエリを実行するアカウントを選びます。
データを説明する
一時停止中のキャンペーンとその予算、クリック数の多い上位の検索語句など、欲しいものを普通の言葉で伝えます。
クエリを確認する
実行する前に、アシスタントが書いた GAQL を表示してもらい、フィールドとフィルターを確認します。
実行して絞り込む
実行したら、日付フィルターや件数の上限でクエリを絞り込み、必要な表になるまで調整します。
結果を確認する方法
クエリで得た合計を、一つのキャンペーンについて Google Ads の同じ合計と比べます。一致すれば、表の残りも信頼できます。
次の二つのプロンプトを、この順に使ってGAQL クエリを実行します。
PaidSync.ai があなたを守る仕組み
- 何も変更されません。
run_gaql_queryとlist_accountsはアカウントを読み取るだけなので、キャンペーンが編集されることはありません。 - 必要なら読み取り専用にできます。PaidSync.ai の API キーは Google Ads で読み取りとプレビューしかできないため、
run_gaql_queryとlist_accountsは、何も変更できないキーでも動作します。トークンは保存時に暗号化されます。
PaidSync.ai が提供する Google Ads ツールはすべて Google Ads MCP サーバーのページに掲載されており、GAQL クエリの実行に使うツールも含まれます。
よくある質問
Google Ads で GAQL クエリを実行するにはどうすればよいですか？
Google Ads では、クエリビルダーまたは API を開いて GAQL 文を書きます。PaidSync.ai を使えば、Claude や ChatGPT に普通の言葉で頼むだけで、クエリの作成と実行を任せられます。
GAQL クエリでアカウントを変更できますか？
いいえ。run_gaql_query は読み取り専用です。変更は書き込みツールを通して行い、先にプレビューが表示されます。
ChatGPT で Google Ads の GAQL クエリを実行できますか？
はい。PaidSync.ai は Google Ads を ChatGPT と Claude の両方に接続し、同じツールが両方で動くため、Claude と同じ方法でGAQL クエリの実行を依頼できます。
GAQL クエリを実行する前に何が必要ですか？
接続済みの Google Ads アカウントです。クエリは、説明をもとに作成されます。
料金はいくらですか?
PaidSync.ai は月 100 タスク（$50 相当）まで無料で、カードは不要です。GAQL クエリを実行し、その結果を確かめるのに十分です。Pro は月額 $99 からです。料金をご覧ください。