Google広告のロゴ

広告

接続する Google広告 Excel、Google Sheets、AI、RESTへ

キャンペーン、広告グループ、キーワード、支出をクエリ可能なテーブルとして提供します。これらのテーブルを、Postgresに保存されているコンバージョンデータやスプレッドシートのエクスポートフォルダと結合できます。

無料で始めよう 13の目的地

一つの接続、あらゆる表面

Google広告データがどこに保存されるか

Google広告 ライブAPIデータ SQLテーブルとして
フェデレーションクエリ + その他のコネクタ 1つのSQL 複数のソースから · すべてのプラン
ネットワーク・エージェント
  • 1 発信接続
  • 0 受信ポート
  • 読み取り専用 · 認証情報はそのまま保持されます

走る

Query Streams は、Google 広告アカウントを 12 個の SQL テーブル (キャンペーン、広告グループ、広告、キーワード、検索語句、地域、デバイス、ユーザー属性、ランディングページ、変更履歴) に変換し、Microsoft Excel、Google スプレッドシート、Power BI、MCP 経由の AI アシスタント、および REST エンドポイントから読み取り可能にします。支出は収益と結合できる列として提供されるため、これが 1 つの重要なポイントです。通常、スプレッドシートで月に一度行われる照合作業が、1 つの明細書にまとめられます。

  1. チーム、ベンダー、パートナーの皆様へ

  2. Google広告からExcelへ Microsoft Excel · Excelアドイン

    Google広告のリアルタイム結果をワークシートに直接取り込み、必要に応じて更新できます。対応プラットフォームは、デスクトップ版Excel、Excel Online、Microsoft 365です。

    Excelの仕組み

  3. Google広告からGoogleスプレッドシートへ Sheetsアドオン

    サイドバーから保存済みのGoogle広告クエリを実行し、結果をスプレッドシートにドラッグ＆ドロップしてください。共有されている共同作業者は、各自でスプレッドシートを更新できます。

    Googleスプレッドシートの仕組み

  4. ノヴァにGoogle広告について聞いてみよう Nova AI · テキストからSQLへ

    分かりやすい英語で質問してください。Novaは既にGoogle広告のテーブルを把握しており、SQL文を作成して実行し、回答を説明してグラフ化します。クエリを作成する必要も、認証情報を提供する必要もありません。

    Novaの仕組み

  5. Google広告からデータビューアへ 結果共有 · チーム、ベンダー、パートナー · 電話、タブレット、デスクトップ

    Google広告のリアルタイム結果を、同僚、取引先、パートナーなど、誰とでも共有できます。共有されたグリッドはブックマーク可能で、スマートフォン、タブレット、デスクトップなど、どのデバイスで開いても常に最新の状態が表示されます。相手には結果のみが表示され、SQLや認証情報は一切表示されません。

    データビューアの仕組み
  6. アプリとシステム向け

  7. Google広告REST API HTTPエンドポイント

    認証済みのJSONエンドポイントとしてGoogle広告クエリを公開し、OpenAPI 3.1仕様に準拠し、Postman、Insomnia、Hoppscotch用の既製コレクションも用意されているため、あらゆるアプリケーションから呼び出すことができます。データベースポートは開放されません。

    REST APIの仕組み

  8. Google広告からPower BIへ Power Query M

    生成された Power Query M を Power BI の詳細エディターに貼り付けると、レポートは HTTPS 経由で Google 広告のリアルタイムの結果を読み取ります。ODBC ドライバーもデータベース ポートも必要ありません。

    Power BI の仕組み

  9. Google広告からAirtableへ 自動化プラットフォーム

    Google広告の行をスケジュールに基づいてAirtableベースに同期したり、Airtable自動化スクリプト内で取得したりできます。

    Airtableの仕組み

  10. BaserowへのGoogle広告 自動化プラットフォーム

    RESTエンドポイント経由でGoogle広告からBaserowテーブルにデータを提供します（セルフホスト型またはBaserowクラウド）。

    Baserowの仕組み

  11. Google広告からSeaTableへ 自動化プラットフォーム

    ファイルをエクスポートしたりデータベースを公開したりすることなく、SeaTableのデータベースをGoogle広告データで常に最新の状態に保つ。

    SeaTableの仕組み

  12. Google広告からSmartsheetへ 自動化プラットフォーム

    Google広告の結果をSmartsheetのグリッドにプッシュすることで、計画やレポートが先週のエクスポートデータではなく、元のシステムから読み込まれるようになります。

    Smartsheetの仕組み

  13. Google広告からAnvilへ Anvil Works · アプリプラットフォーム

    Anvil Pythonアプリにデータベース認証情報を埋め込む代わりに、RESTエンドポイントを介してGoogle広告を連携させる。

    Anvilの仕組み
  14. AIツール向け

  15. Google広告MCPサーバー Claude、Cursor、およびMCPクライアント

    AIアシスタントに、正しいSQLを作成するために必要なスキーマを含むGoogle広告への読み取り専用アクセス権を付与します。チャットに認証情報を含めないでください。

    Google広告ガイド
  16. 人々に届けられる

  17. Google広告のアラートとレポート Slack · Discord · メール · Webhook

    Google広告のクエリをスケジュール設定し、結果をSlack、Discord、メール、または署名付きWebhookに送信するか、行数、しきい値、またはパーセンテージの変化が設定した値を超えるまでメッセージを保留することができます。

    アラートとレポートの仕組み

仕組み

5つのステップ、受信ファイアウォールの変更は不要

01

Google広告アカウントの開発者トークンを取得し、ドメイン全体に委任できるサービスアカウントを作成してください。

02

ネットワークエージェントをインストールし、サービスアカウントキー、開発者トークン、なりすましに使用するメールアドレス、および顧客IDを指定します。サブアカウントにアクセスするためのマネージャーアカウントIDはオプションです。

03

同期する12個のテーブルから選択してください。キャンペーン、広告グループ、キーワード、検索語句、地域、デバイス、およびアカウント自体はデフォルトで有効になっています。

04

gads.campaign、gads.search_term_view、その他に対して通常のSQLを記述するか、Novaに記述させることもできます。

05

Excel、Sheets、Power BI、MCP、またはRESTなど、収益データが保存されているあらゆる媒体からデータを読み込むことができます。

機能の詳細解説

Google広告が提供するもの

ある声明では、支出は収益に次ぐものだと述べている。

Google広告は、あなたがいくら費用をかけたかは把握していますが、顧客が実際にいくら支払ったかは把握していません。そして、重要なレポートには、その両方が必要なのです。

  • gads.campaign には、日ごとのインプレッション数、クリック数、コスト、コンバージョン数、コンバージョン値が格納されているため、キャンペーン名または UTM をキーとするデータときれいに結合できます。
  • gads.search_term_viewは、実際に誰かが入力したクエリであり、通常、そこから資金が流出する。 さらに、広告インターフェースに閉じ込められることなく、独自のコンバージョンデータと連携させることができます。
  • 送金はAPIが報告する通り、マイクロ単位で行われます。1ドルは1,000,000なので、自分で割り算をする前に丸め処理は一切行われていません。

12のテーブル

  • 構造 — 顧客、キャンペーン、広告グループ、広告グループ広告。
  • 検索 — キーワード表示、検索語句表示、ランディングページ表示。
  • 故障 — 地理的表示、デバイス表示、年齢範囲表示、性別表示。
  • 監査 — 変更履歴。
  • 各行には、完全なAPIレスポンスがraw_data JSON列に保持されるため、名前付き列ではないメトリックも存在します。

数字がどこまで続くのか、正直言って

広告データに関して、どのツールも受け入れざるを得ない2つの点について、後から発見するのではなく、はっきりと述べておきます。

  • 報告は昨日までで、今日までではない。 ―今日の数値はGoogle側では不完全であり、誤解を招くだけです。
  • 増分実行のたびに、過去数日分と最新のデータが再読み込みされます。これは、コンバージョンの反映が遅れるため、月曜日に取得した数値が木曜日までにGoogleが確定する数値とは異なるためです。
  • 変更履歴は、Google広告API自体によって29日間に制限されています。これは最近の変更履歴を表示するフィードであり、永続的な監査ログではありません。
  • 地理情報欄の中には、地名ではなくGoogleの基準IDが表示されているものがあり、広告コピー欄の中にはまだ入力されていないものもあります。表示されている情報は正確であり、表示されていない情報は誤りではなく空欄です。

すべてのAPIコネクタで共有されます

各APIコネクタの仕組み

  • あなたのアカウントはテーブルになります エンドポイントは、主キーとインデックスを持つ型付きSQLテーブルにマッピングされるため、JSONをページングする代わりに、SELECT、JOIN、GROUP BYを記述します。
  • 同期する項目と頻度は自分で選択できます。 各テーブルにはそれぞれ独自の間隔が設定されている場合と、間隔が設定されていない場合がある。ベンダーのAPIが対応している場合は、前回の実行以降に変更されたレコードのみが取得される。
  • コピーはあなたのものです — それは、お客様のマシン上のエージェントと同じ場所にある、AES-256-GCMで暗号化されたDuckDBファイル内に存在します。当社のクラウド上にはありません。
  • ベンダーはあなたからしか連絡を受けない エージェントはユーザー自身のネットワークから直接APIを呼び出すため、クエリストリームがクエリに応答する際にトークンは必要ありません。

知っておくと良い

  • これは同期されたコピーであり、ライブプロキシではありません。 クエリは既に取得済みのデータを読み取るため、SQLの速度で処理が進み、APIのレート制限を消費することはありません。選択したテーブルでは、読み取り時に古い行を更新することも可能です。
  • レート制限は尊重されます 各コネクタはベンダーが公表している制限値を十分に下回るペースで動作するため、レポートによって、そのコネクタを使用する他のすべてのアカウントが制限されることはありません。
  • 何も捨てられない テーブルに名前が付けられていないフィールドは、クエリ可能なraw_data JSON列に保持されます。
  • データベースに結合してください — 同じステートメント内で API テーブルと SQL Server テーブルを使用することは、ここでは通常のクエリであり、統合プロジェクトではありません。

クロスソースSQL

Google広告を他のデータと連携させる

Google広告の支出と収益は全く別の場所に存在するため、通常は月に一度スプレッドシートで両者を照合します。1つの明細書で、キャンペーン、キャンペーンが発生したアカウント、請求された請求書をまとめて確認できます。各ソースは実行可能な部分のみを実行し、結果をストリーミングで送信し、結合は中央で行われます。ソース同士が直接やり取りしたり、データがどこかにコピーされたりすることはありません。

接続数3件・エージェント数3名

Google広告 広告
PostgreSQL 関係エンジン
ストライプ 支払いと請求

一つの声明

-- Google広告からの支出、データベースのアカウント、Stripeからの収益
セレクト   g.campaign_name、SUM(g.cost_micros) / 1000000 AS spend、SUM(i.amount_due) AS invoiced
フロム     広告.gads.キャンペーン1       g
ジョイン     pg_crm.一般顧客2 c ON c.utm_campaign = g.campaign_name
ジョイン     請求する.stripe.invoices3 i ON i.customer = c.stripe_id
GROUP BY g.キャンペーン名
ORDER BY 請求書記載のDESC;

接続、スキーマ、テーブルの 3 つの部分で構成され、接続名はユーザーが付けた名前になります。これは例示用の列です。テーブルはユーザーが作成したテーブルになります。コストは Google Ads API が報告するマイクロ単位で届くため、割り算はユーザーが行う必要があり、途中で丸められることはありません。読み取り専用はすべての部分に適用されます。SELECT、WITH、EXPLAIN のみで、1 つのクエリに対して 1 つのソースが渡せる量には上限があります。 フェデレーションクエリの仕組み

接続の詳細

Google広告に必要なもの

認証
ドメイン全体に委任されたGoogleサービスアカウントキー、開発者トークン、およびそれが偽装するメールアドレス。これらはすべてエージェント上に保持されます。
アカウント
顧客ID、およびサブアカウントにアクセスするためのオプションの管理者アカウントID
手を伸ばして
お客様のネットワークからGoogle広告APIへの通信はHTTPSで行います。受信通信はありません。
スキーマ
gads — つまり、gads.campaign、gads.search_term_view
表
12 項目のうち、7 項目はデフォルトで有効になっています: customer、campaign、ad_group、keyword_view、search_term_view、geographic_view、device_view
お金
APIが報告するマイクロ単位では、通貨単位の場合は100万で割ります。
鮮度
昨日まで遡って実行します。各インクリメンタルパスは過去3日間を再読み込みし、遅れて割り当てられたコンバージョンが反映されます。
歴史
初回同期から90日間。change_historyはGoogleによって29日間に制限されています。
ローカルコピー
エージェントと同じマシン上に、AES-256-GCMで暗号化されたDuckDBファイルがあります。

読み取り専用は構造的なものです。コネクタはGoogleの検索クエリを発行するだけで、変更呼び出しは一切含まれていないため、クエリによって入札額を変更したり、キャンペーンを一時停止したり、費用を1セントたりとも支出したりすることはできません。

クロスソースクエリでは、3つの部分からなる参照の中央部分はgadsです。キャンペーンテーブルを読み取るadsという接続は、ads.gads.campaignと記述されます。

ベンダー資料： ads.google.com

よくある質問

Google広告に関する質問

クエリ ストリームを通じて Google 広告データを読み取ることができるツールはどれですか？

Excel、Google Sheets、MCP、REST API、Airtable、Baserow、SeaTable、Smartsheet、Anvil、Power BI、スケジュールされたアラートやレポートなど、すべてを1つの接続で利用できます。アカウントを一度接続すれば、すべてのインターフェースが同じ読み取り専用接続を読み取ることができます。ツールごとの設定やデータの複製は一切不要です。

Google広告アカウントへのファイアウォールポートを開放する必要がありますか？

いいえ。Query Streams Network Agentはネットワーク内で動作し、暗号化された単一の送信接続を開きます。受信トラフィックを監視するものはなく、VPNも不要で、アカウントは既存のファイアウォールルールを維持します。

クエリ ストリームは Google 広告のデータを変更することができますか？

いいえ。エージェントは実行時に読み取り専用を強制します。つまり、一度に1つのステートメント（SELECT文など）のみを実行します。認証情報はエージェント上に保持され、クエリ ストリームに送信されることはありません。

クエリ ストリームが Google 広告に接続するために必要なものは何ですか？

到達可能なホスト、ロール、およびそのパスワード - エージェントがドライバーを保持するため、アカウントには何もインストールされません。認証: ドメイン全体に委任された Google サービス アカウント キー、開発者トークン、およびそれがなりすますメール。すべてエージェントに保持されます。アカウント: 顧客 ID、およびサブ アカウントにアクセスするためのオプションのマネージャー アカウント ID。アクセス方法: ネットワークから Google Ads API への HTTPS。受信はありません。スキーマ: gads - つまり、gads.campaign、gads.search_term_view。

同じクエリ内で、Google広告を別のデータベースに結合することはできますか？

はい、それはフェデレーションクエリです。1つのステートメントで、Google広告と他の接続を同時に参照でき、connection.schema.table の形式で記述されます。各ソースは実行可能な部分のみを実行し、結果をストリームで返します。結合は中央で行われるため、ソース同士が接続されることはなく、何もコピーまたはスケジュールされません。読み取り専用はすべての部分（SELECT、WITH、EXPLAINのみ）に適用され、1つのソースが単一のクエリで渡せるデータ量には上限があります。フェデレーションクエリはプラン機能であり、フェデレーションクエリのページには現在のソースとサイズの制限が表示されます。

Google広告は、実際に仕事が行われる場所に掲載しましょう。

エージェントをインストールし、アカウントを指定して、送信先を選択してください。

無料で始めよう すべてのコネクタ

読み取り専用 発信専用 認証情報はエージェントに保持されます