カテゴリーを見る

Google AnalyticsをGoogle Sheetsに接続する方法 - SQLでウェブ解析を照会する

GoogleスプレッドシートとGA4を接続する

データ取得元 GA4 の中へ グーグル シート

GA4アカウントから最新のデータをGoogleスプレッドシートに取り込み、いつでも更新できます。CSVファイルのアップロードも、Apps Scriptも、コピー&ペーストも不要です。初回は約10分で完了し、無料プランで利用できます。

約10分 コーディングは不要です 認証情報はあなたと共にあります どのブラウザでも、どのデバイスでも
行き詰まったら、遠慮なく質問してください。 開く サポート クエリ ストリーム(右上メニュー → サポート)からメッセージを送信してください。担当者が目を通しますので、「この画面で何を求めているのか分かりません」というご質問は、全く問題ありません。

最終的に手に入るもの

Google Analytics 4 のロゴGA4アカウントに対するSQLクエリのリアルタイム結果を表示するGoogleスプレッドシート。データが変更されるたびに最新の行を取得するボタンが付いています。例:

Google Analytics 4 は、API を介してデータを保持します。通常、データを Google スプレッドシートに取り込むには、最新の数値が必要になるたびに GA4 ダッシュボードから CSV ファイルをエクスポートする必要があります。Query Streams を使用すれば、この手間を省くことができます。エージェントと呼ばれる小さなヘルパープログラムがデータのある場所でクエリを実行し、Google スプレッドシートのアドオンが必要な行を取得します。暗号化されたリンクを介して送信されるのは結果のみで、Google スプレッドシートはあらゆる場所、あらゆるデバイスのあらゆるブラウザで使用できます。

エージェントが走る場所インターネットに接続された常時稼働のコンピュータまたはサーバーあなたのGA4アカウント鍵はここに置いておくクエリストリームエージェント資格情報を保持クエリストリーム暗号化されたリンクインターネット経由 · 結果のみあなたがどこにいてもあらゆるブラウザ:ノートパソコン、タブレット、スマートフォン、Chromebookグーグル シート行はシート状で届きます
エージェントはあなたのデータと共に存在します。スプレッドシートはGoogleのクラウドに保存されます。どこからでも開くことができ、行データが表示されます。

必要なもの

クエリストリームアカウント

このガイドは無料プランで十分です。登録はこちらから my.querystreams.com.

常時稼働しているコンピュータ上のエージェント

バックグラウンドで動作し、Google スプレッドシートから要求があった際に GA4 を呼び出す小さなプログラムです。インターネット接続さえあれば動作します。

GA4へのログイン

GA4に一度ログインして、読み取りアクセスを許可してください。クエリ ストリームにパスワードを入力する必要はありません。

どのコンピュータにエージェントがインストールされますか? GA4アカウントにアクセスできる、常時稼働しているマシンであればどれでも構いません。 Google スプレッドシートはどこにでも配置できますブラウザ上で動作します。

接続方法は5つのステップです

  1. アカウントを作成する

    行く my.querystreams.com そしてサインアップします。 無料 これは計画です。試用版ではなく、本格的な計画であり、GA4アカウントの接続方法やGoogleスプレッドシートからのクエリ実行方法などを網羅しています。

  2. 常時稼働している任意のコンピューターにエージェントをインストールしてください。

    サインインして開く ダウンロードインターネットに接続された常時稼働のコンピュータまたはサーバーにエージェントをインストールしてください。インストールには1分ほどかかり、その後は自動的に起動します。

    ドライバではなく、なぜ小さなプログラムを使うのか? エージェントは、Windows、Mac、Linux 用の単一のインストール(Windows では約 85 MB、Mac と Linux では 100 MB 強)で、バックグラウンドで静かに動作します。ブラウザと同様に、Query Streams への暗号化されたアウトバウンド接続を 1 回確立するため、ファイアウォールのポートを開放したり、VPN を設定したりする必要はありません。キーはマシン上に保持され、行データは必要に応じてインターネット経由でユーザーのいる場所まで送信されます。ユーザー側で必要なのは、このアドオンだけです。

    ダウンロードページには アクセスキーエージェントに求められたら貼り付け、バッジが読み取るまで待ちます。 クエリ ストリームに接続しましたエージェント本体で行う操作はそれだけです。

    ご希望であれば、完全攻略ガイドもご用意しています。 Windows, マック, Linux.

  3. GA4アカウントを指定してください。

    ブラウザに戻って、 データエージェント (下 データ 上部メニューにあります。エージェントがそこに表示されています。クリックしてください。 コネクタを追加する そして選択する グーグルアナリティクス4まずGA4の認証情報が必要ですか?チュートリアルを開いて、以下を入力してください。

    GA4の認証情報を作成してください。 (約15分)

    別のタブでGoogle Analytics 4を開いた状態で、この手順を実行してください。Query Streamsはここで作成したデータを保持し、エージェントがそれを利用できるようにします。また、Query Streamsは常にGoogle Analytics 4からのみデータを読み取ります。

    誰がこれをできるのか
    Google Analytics: GA4プロパティまたはそのアカウントの管理者であること(サービスアカウントを追加するために必要)。 Google Cloud: プロジェクトの所有者であること(作成したプロジェクトの所有者はあなた自身です)、またはそのプロジェクトに対して「サービスアカウントの作成」、「サービスアカウントキー管理者」、「サービス使用状況管理者」のロールが付与されていること。
    推奨
    Google CloudサービスアカウントのJSONキー(service_accountタイプの.jsonファイル)。サービスアカウントはGA4プロパティのビューアーとして追加されています。

    始める前に

    • GA4プロパティです。プロパティIDは単なる数字です。UA-トラッキングIDは、GoogleのAPIでは読み取れない古いUniversal Analyticsプロパティを意味します。
    • その GA4 プロパティの管理者権限を持つ Google アカウントが必要です。もしお持ちでない場合は、Google Cloud の部分 (手順 1 ~ 13) を実行し、管理者に手順 14 ~ 19 の実行を依頼してください。
    • 管理可能な Google Cloud プロジェクト、またはプロジェクトを作成する権限が必要です。会社の Google Cloud 組織が 2024 年 5 月 3 日以降に作成された場合、Google はデフォルトでキーのダウンロードをブロックするため、Google Cloud 管理者が許可する必要がある場合があります (よくある問題を参照)。
    • クエリ ストリーム ウィザードは、エージェントがオンラインの状態で別のタブ (データ エージェント → コネクタの追加 → Google Analytics 4) で開きます。

    手順

    1. Google Cloudで新規プロジェクトページを開く

      Googleアカウントでサインインし、Google Cloudの新規プロジェクトページを開きます。

      既に使用したい Google Cloud プロジェクトをお持ちですか?それなら手順 3 に進んで、そこでプロジェクトを選択してください。Google Cloud を初めて開くと、ページが表示される前に、国名と利用規約への同意を求められる場合があります。

    2. プロジェクトに名前を付けて作成する

      プロジェクト名には、「Query Streams GA4」などの名前を入力します。組織または場所の欄は、Googleが自動的に入力するままにしておきます(組織を指定しなくても構いません)。「作成」をクリックします。

      Googleはプロジェクトを作成するのに請求アカウントを必要としません。作成には数秒から1分程度しかかかりません。

    3. プロジェクトを選択してください

      ページ上部のGoogle Cloudロゴの横にあるプロジェクト選択ツールをクリックし、プロジェクト名をクリックしてください。以下のGoogle Cloudの手順はすべて、このプロジェクト内で実行されます。

      最もよくある間違いは、あるプロジェクトでAPIを有効にして、別のプロジェクトでキーを作成することです。Google Cloudの各手順を実行する前に、ページ上部のプロジェクト名を確認してください。

    4. Google Analytics Data API を有効にする

      APIライブラリでGoogleアナリティクスデータAPIページを開きます。ページ上部にプロジェクト名が表示されていることを確認してから、「有効にする」をクリックします。

      Google Analytics Data APIを選択してください。Google Analytics Reporting APIは古いUniversal Analyticsプロパティでのみ動作します。ボタンが「有効にする」ではなく「管理」と表示されている場合は、APIは既に有効になっています。このAPIはGA4のリアルタイムレポートも提供するため、realtime_active_usersテーブルで別途有効にする必要はありません。

    5. Google Analytics Admin API を有効にする(推奨)

      APIライブラリでGoogleアナリティクス管理APIページを開き、「有効にする」をクリックします。

      同期処理にはこのAPIは必要ありません。このAPIは、クエリストリームウィザードのGA4プロパティIDの横にある「検出」ボタンの動作を支えており、サービスアカウントが参照できるプロパティの一覧を表示します。プロパティIDを手動で入力する場合は、この手順をスキップしてください。

    6. サービスアカウントを開始する

      サービスアカウントページを開きます。Google Cloud内からナビゲーションメニュー(左上の3本線)を開き、[IAMと管理] → [サービスアカウント]を選択することもできます。[+ サービスアカウントを作成]をクリックします。

      Query StreamsのGoogle Search Consoleコネクタ用のサービスアカウントを既に作成済みですか?それなら、ここでも使用できます。プロジェクトの手順4と5を実行し、その後、メールアドレスとキーを使って手順14に進んでください。

    7. サービスアカウントに名前を付ける

      サービスアカウント名に「query-streams-ga4」と入力します。GoogleがそこからサービスアカウントIDを自動的に入力します。説明は任意です。「作成して続行」をクリックします。

      IDは後から変更できません。サービスアカウントのメールアドレスの最初の部分になります。

    8. プロジェクトの役割をスキップする

      次のセクションでは、プロジェクトにおける役割が表示されます。役割欄は空欄のままにして、「続行」をクリックしてください。

      サービスアカウントに、ここでは所有者、編集者、閲覧者権限を与えないでください。Google Analyticsへのアクセス権は、手順18でGoogle Analytics内で付与されます。プロジェクトロールはGoogle Analyticsでは何も機能せず、Google Cloudにおけるキーの機能を拡張するだけです。

    9. サービスアカウントの作成を完了してください。

      最後のセクション(サービスアカウントを使用または管理できるユーザー)は空欄のままにして、「完了」をクリックしてください。サービスアカウント一覧画面に戻ります。

    10. サービスアカウントのメールをコピーしてください。

      リストの中から新しいアカウントを探してください。そのメールアドレスは [email protected] のようになります。これをコピーして、手順17のために保管しておいてください。

      .iam.gserviceaccount.com からアドレス全体をコピーしてください。新しいサービスアカウントが使用可能になるまでには、1分以上かかる場合があります。

    11. 「キー」タブを開く

      サービスアカウントのメールアドレスをクリックし、次に「キー」タブをクリックします。

    12. 新しいキーを開始する

      「キーを追加」をクリックし、「新しいキーを作成」を選択します。

      Googleが「サービスアカウントキーの作成が無効になっています」と表示する場合、組織がキーのダウンロードをブロックしている可能性があります。よくある問題を参照してください。

    13. JSONキーをダウンロード

      キーの種類としてJSONを選択し、「作成」をクリックします。ブラウザがプロジェクト名と同じ名前の.jsonファイルをダウンロードします。通常はダウンロードフォルダに保存されます。

      このダウンロードは一度だけ行われます。Google はコピーを保存せず、ファイルを再度ダウンロードすることはできません。紛失した場合は、新しいキーを作成して古いキーを削除してください。P12 は選択しないでください。ファイルは非公開にしてください。メールで送信したり、共有フォルダに保存したりしないでください。ファイルを持っている人は誰でも Analytics データを読み取ることができます。Query Streams はエージェント用にファイルを保存し、そのファイルを使用してのみ読み取りを行います。

    14. Googleアナリティクス管理画面を開く

      Google Analyticsを開き、管理画面(左下にある歯車アイコン)をクリックします。ページ上部の「アカウントとプロパティの選択」で、読み取りたいGA4プロパティが表示されていることを確認してください。

      ユーザーを追加するには、この物件またはそのアカウントの管理者権限が必要です。管理者権限をお持ちでない場合は、手順10のメールを管理者権限を持つ方に送信し、手順15~19を実行していただくよう依頼してください。

    15. オープンプロパティアクセス管理

      プロパティ設定の「プロパティ」グループで、「プロパティアクセス管理」をクリックします。

      アカウントアクセス管理ではなく、プロパティアクセス管理を使用してください。アカウントレベルで追加されたアクセス権限は、アカウント内のすべてのプロパティに適用されます。

    16. ユーザーを追加する

      右上の青い「+」ボタンをクリックし、「ユーザーを追加」を選択してください。

    17. サービスアカウントのメールアドレスを入力してください

      手順10で取得したサービスアカウントのメールアドレスをメールボックスに貼り付けます。「新規ユーザーにメールで通知する」のチェックを外します。

      そのアドレスの受信トレイは誰も読まないので、通知しても意味がありません。GA4 から「このメールアドレスは Google アカウントと一致しません」または「ユーザーの追加に失敗しました: メールアドレスが見つかりません」というメッセージが返ってきた場合は、「よくある問題」を参照してください。Google では、2026 年 4 月以降、新規作成されたサービス アカウントで既知の問題が発生しており、数時間待つことで多くのユーザーで解決しています。

    18. 閲覧者ロールを選択してください

      役割一覧で「閲覧者」を選択します。「コスト指標なし」と「収益指標なし」のデータ制限はチェックを外したままにします。

      ビューアーで十分です。クエリ ストリームはレポートを読み取るだけだからです。「収益指標なし」にチェックを入れると、Google は ecommerce_overview テーブルと transactions テーブルのすべての収益列に 0 を返します。

    19. サービスアカウントを追加する

      右上の「追加」をクリックします。サービスアカウントが、閲覧者ロールでプロパティのユーザーリストに表示されます。

      画面によっては、このボタンに「作成」というラベルが付けられています。

    20. 物件IDをコピーしてください

      管理画面に戻ります。「プロパティ設定」の「プロパティ」グループで、「プロパティの詳細」をクリックします。右上に「プロパティID」という数字(例:486480978)が表示されます。その横にあるコピーアイコンをクリックします。

      測定ID(G-で始まる)やアカウントIDではなく、この番号を使用してください。同じ番号は、GA4のアドレスバーの「p」の後に表示されています。例:…/p486480978/…。

    21. キーファイル全体をコピーする

      手順13で作成した.jsonファイルをテキストエディタで開きます。Windowsの場合は、ファイルを右クリックして「プログラムから開く」→「メモ帳」を選択します。Macの場合は、Controlキーを押しながらファイルをクリックし、「プログラムから開く」→「TextEdit」を選択します。Ctrl+Aを押し、次にCtrl+Cを押します(Macの場合はCmd+Aを押し、次にCmd+Cを押します)。

      最初の { から最後の } まで全てコピーしてください。一切の修正や書き換えはしないでください。private_key の行は、Google が書いたとおりにそのままにしておいてください。

    許可を与える

    リソースアクセス用途
    Google Analyticsのプロパティロール:閲覧者(プロパティアクセス管理)視聴者すべての ga4 テーブル: traffic_overview、traffic_sources、geographic_data、page_views、user_engagement、events、ecommerce_overview、transactions、realtime_active_users。テスト接続では、プロパティのフィールドリストも一緒に読み取られます。
    データ制限:収益指標は表示できませんチェックなしecommerce_overview テーブルの収益列 (purchase_revenue、total_revenue、average_purchase_revenue) と transactions (item_revenue)。チェックを入れると、Google はこれらの列に 0 を返します。
    データ制限:コスト指標なしチェックなし(推奨)現在、クエリ ストリーム テーブルでコスト メトリックを読み取るものはありませんので、この設定は現時点では問題ありません。チェックを外したままにしておけば、コスト データはすべて読み取り可能な状態になります。
    Google Cloud API: Google AnalyticsデータAPI有効すべてのga4テーブルとテスト接続。realtime_active_usersの背後にあるリアルタイムレポートは、同じAPIの一部です。
    Google Cloud API: Google Analytics 管理者 API有効化(オプション)GA4プロパティIDの横にある「検出」ボタンのみ、サービスアカウントが表示できるプロパティの一覧を表示します。テーブルはそれを読み取りません。
    サービスアカウントの Google Cloud プロジェクトロールなしどのテーブルにも必要ありません。Google Analyticsへのアクセス権限は、上位の閲覧者ロールを持つユーザーのみに付与されます。
    OAuthスコープ https://www.googleapis.com/auth/analytics.readonlyエージェントからの依頼です(設定する必要はありません)すべてのga4テーブル、接続テスト、検出。これはGoogleの読み取り専用アナリティクススコープなので、キーによってGoogleアナリティクスで何も変更することはできません。

    クエリ ストリームに貼り付ける

    サービスアカウントのJSONキー
    ステップ21でコピーした.jsonファイルの内容全体(最初の{から最後の}まで)を貼り付けてください。後でコネクタを編集する際は、このボックスを空白のままにして保存済みのキーを保持するか、新しいファイルを貼り付けて置き換えてください。
    GA4物件ID
    ステップ20でコピーした数字のみを入力してください(例:486480978)。または、ボックスの横にある「検出」をクリックして、リストから物件を選択してください。「検出」には、ステップ5で取得した管理者APIと、オンラインのエージェントが必要です。

    よくある問題

    接続テストが「無効なキータイプ」で失敗しました。「service_account」が必要です。

    なぜ: 貼り付けられたファイルはサービスアカウントキーではありません。通常は、OAuthクライアントファイル(client_secret_….jsonのような名前)か、APIとサービス → 認証情報にあるAPIキーです。

    修理: サービスアカウントにJSONキーを作成し(手順11~13)、そのファイルを貼り付けます。サービスアカウントキーには、「type」:「service_account」という行が含まれます。

    接続テストが、無効なJSON形式、または「private_key」フィールドの欠落もしくは空によって失敗します。

    なぜ: ファイルの一部のみがコピーされたか、コピー中にテキストが変更されました。

    修理: メモ帳またはテキストエディットでファイルを再度開き、Ctrl+A(Macの場合はCmd+A)を押してコピーし、前後に何も追加せずに「Service Account JSON Key」に貼り付けます。

    接続テストが失敗しました。「アクセス禁止 - ユーザーにはこのプロパティに対する十分な権限がありません」というエラーが表示されます。

    なぜ: サービスアカウントがこの物件に追加されていないか、別の物件に追加されているか、または物件IDが別の物件に属している可能性があります。また、サービスアカウントを追加した直後の数分間にもこの現象が発生します。

    修理: 物件の詳細に同じ物件IDが表示されている物件を開き、サービスアカウントのメールアドレスがViewerを使用した物件アクセス管理にリストされていることを確認します(手順14~19)。5~10分待ってから、もう一度「テスト」をクリックします。

    接続テストが失敗し、「Google Analytics Data API はプロジェクト…で以前に使用されたことがないか、無効になっています」という Forbidden メッセージが表示されます。

    なぜ: このキーが属する Google Cloud プロジェクトでは、Data API が有効になっていません。プロジェクト名は、キーファイルの project_id 行に記載されています。

    修理: Google Cloud でそのプロジェクトを選択し、Google Analytics Data API を有効にし(手順 4)、数分待ってから、もう一度「テスト」をクリックします。

    接続テストが失敗しました。プロパティIDの形式が無効です: 'G-…'。数値である必要があります。または、プロパティ '…' が見つかりません。

    なぜ: プロパティIDの代わりに、測定ID(G-…)、古いUAトラッキングID、または入力ミスのある番号が入力されました。

    修理: 物件詳細ページ(手順20)の「物件ID」の下に表示されている番号をコピーし、GA4の「物件ID」に貼り付けます。

    Google Analytics がサービス アカウントのメールアドレスを受け付けません: このメールアドレスは Google アカウントと一致しません、または、ユーザーの追加に失敗しました: メールアドレスが見つかりません。

    なぜ: Googleで既知の問題:2026年4月下旬以降、GA4とSearch Consoleが、新しく作成されたサービスアカウントをしばらくの間認識しないことがある。この問題は2026年9月まで報告され続けた。アドレスにタイプミスやスペースが含まれている場合も、同じメッセージが表示される。

    修理: スペースを入れずにアドレスを再度貼り付けてください。それでも拒否される場合は、数時間待ってから再度お試しください。以前に作成したサービスアカウントは通常機能するため、既に作成済みのサービスアカウントをお持ちの場合は、そのアカウント用に新しいキーを作成し(手順11~13)、そのメールアドレスを追加してください。Google API Explorer の操作に慣れている管理者は、Admin API の accessBindings.create メソッドと predefinedRoles/viewer ロールを使用してサービスアカウントを追加することもできます。

    Google Cloudでは、「新しいキーを作成」をクリックすると、サービスアカウントキーの作成が無効になっていると表示されます。

    なぜ: お客様の組織では、ポリシー iam.disableServiceAccountKeyCreation が適用されています。Google では、2024 年 5 月 3 日以降に作成された組織に対して、このポリシーをデフォルトで有効にしています。

    修理: Google Cloud 管理者 (組織ポリシー管理者ロールを持つユーザー) に、このプロジェクトまたはサービス アカウントのキー作成を許可するよう依頼してください。Google のドキュメントには、1 つのプロジェクトまたはサービス アカウントに対するタグベースの例外設定方法が記載されています。その後、手順 12 と 13 を繰り返してください。

    Detect は「GA4 プロパティが見つかりません」と表示するか、プロジェクトで Google Analytics Admin API が使用されていないことを報告します。

    なぜ: 管理APIが有効になっていない(手順5)、またはサービスアカウントがまだどのプロパティにも追加されていない。

    修理: 管理APIを有効にして手順14~19を完了したら、もう一度「検出」をクリックしてください。プロパティIDは手動で入力することもできます。

    ecommerce_overviewテーブルとtransactionsテーブルは同期していますが、revenue列はすべて0になっています。

    なぜ: サービスアカウントは、「収益指標データなし」の制限付きで追加されました。

    修理: プロパティアクセス管理で、サービスアカウントのエントリを開き、「収益指標なし」のチェックを外して保存します。次回の同期で実際の値が読み込まれます。

    以前は正常に動作していたコネクタが同期を停止し、invalid_grant または Invalid JWT Signature というエラーが表示されます。

    なぜ: このキーはGoogle Cloudで削除または無効化されました。Googleは、公開されているキーも無効化します。

    修理: 新しいキーを作成します(手順11~13)。クエリ ストリームで、データ エージェントのコネクタを開き、「編集」をクリックして、新しいファイル全体を「サービス アカウント JSON キー」に貼り付け、「接続テスト」をクリックしてから、「変更を保存」をクリックします。Google Cloud で古いキーを削除します。

    同期が429またはRESOURCE_EXHAUSTEDエラーで失敗します。

    なぜ: このプロパティは、Google Analytics APIの割り当て量を使い切りました。APIを通じてこのプロパティを読み取るすべてのアプリは、同じプロパティごとの割り当て量を使用します。

    修理: お待ちください。時間ごとの割り当ては1時間以内に補充され、日ごとの割り当ては太平洋標準時午前0時にリセットされます。使用していないテーブルはオフにするか、同期頻度を減らしてください。

    クエリ ストリームがこのプロパティを読み取るのを停止させたい。

    なぜ: コネクタを削除しても、Googleのアクセス権は削除されません。サービスアカウントは閲覧者のままであり、キーも有効なままです。

    修理: プロパティのアクセス管理で、サービスアカウントを削除します。Google Cloud で、サービスアカウントの「キー」タブを開き、キーを削除します。次に、データエージェントでコネクタを削除します。

    知るべき限界

    • データの鮮度:GA4では1日の処理に24~48時間かかる場合があり、その後、直近の数値が変更される可能性があります。日次テーブルの同期では、過去3日間のデータが再読み込みされるため、遅れて入力された数値も自動的に反映されます。リアルタイムデータは数分以内に届きます。
    • リアルタイムウィンドウ:GA4のリアルタイムレポートは、過去30分間(Analytics 360では60分間)のデータのみを対象としています。realtime_active_usersテーブルは履歴ではなく、更新ごとに(デフォルトでは5分ごとに)置き換えられるスナップショットです。他のテーブルと同じAPI、キー、ビューアアクセスを使用し、独自のリアルタイムクォータが設定されています。
    • 標準プロパティのAPIクォータは、プロパティ全体で1日あたり20万トークン、1時間あたり4万トークン、1つのGoogle Cloudプロジェクトから1時間あたり1万4千トークン、同時リクエスト数は10件です。ほとんどのリクエストは10トークン以下で完了します。Analytics 360プロパティは、これらの制限の10倍のクォータが利用できます。1日のクォータは太平洋標準時午前0時にリセットされます。
    • 履歴:最初の同期では、GA4がリリースされた2020年10月以降のすべてのデータが要求されます。Googleは、プロパティがデータ収集を開始した時点以降のデータのみを返します。Universal Analytics(UA-)プロパティは、このAPIでは読み取ることができません。
    • コネクタごとにプロパティは1つです。プロパティIDによって1つのGA4プロパティが選択されます。別のプロパティを読み取るには、同じサービスアカウントをビューアとして追加し、2つ目のコネクタを作成します。どちらのコネクタでも同じキーが使用できます。
    • キー:サービスアカウントキーは、組織が最大有効期間を設定しない限り、期限切れになることはありません。各サービスアカウントには最大10個のキーを設定でき、キーファイルは一度だけダウンロードできます。
    • データ制限:サービスアカウントに収益指標またはコスト指標が設定されていない場合、Google はエラーではなく、これらの指標に対して 0 を返します。

    手順は2026年10月8日に確認済み。出典: developers.google.com/analytics/devguides/reporting/data/v1, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/reporting/data/…, developers.google.com/analytics/devguides/config/admin/v1…, developers.google.com/analytics/devguides/config/admin/v1…, developers.google.com/analytics/devguides/config/admin/v1…, developers.google.com/workspace/guides/create-project, docs.cloud.google.com/resource-manager/docs/creating-mana…, docs.cloud.google.com/service-usage/docs/enable-disable, docs.cloud.google.com/iam/docs/service-accounts-create, docs.cloud.google.com/iam/docs/keys-create-delete, docs.cloud.google.com/iam/docs/service-account-creds, docs.cloud.google.com/iam/docs/troubleshoot-org-policies, docs.cloud.google.com/iam/docs/best-practices-for-managin…, support.google.com/googleapi/answer/6158841?hl=en, support.google.com/analytics/answer/9305788?hl=en, support.google.com/analytics/answer/9305587?hl=en, support.google.com/analytics/answer/9304776?hl=en, support.google.com/analytics/answer/11198161?hl=en, docs.ovhcloud.com/en/guides/public-cloud/data-platform/co…, windsor.ai/documentation/how-to-connect-ga4-to-windsor-ai…, seopress.org/support/guides/find-my-google-analytics-4-pr…, analytify.io/add-user-to-google-analytics, optimizesmart.com/blog/google-analytics-4-measurement-id-…, discuss.google.dev/t/problem-with-new-service-accounts/36…, piunikaweb.com/2026/05/01/google-service-account-email-no…, sanj.dev/post/google-analytics-search-console-service-acc…, oneuptime.com/blog/post/2026-01-24-gcp-service-account-ke…, help.genesys.cloud/articles/data-action-returns-a-400-error.

    接続名
    後で必ず思い出すような名前、例えば「販売データベース」など。
    サービスアカウントのJSONキー
    GA4プロパティにビューアーとして追加されたGoogleサービスアカウントのキーファイルの内容を貼り付けてください。
    GA4物件ID
    GA4プロパティを識別する番号は、GA4管理画面の「プロパティ設定」で確認できます。例えば、486480978などです。

    クリック 接続テスト読むと 接続済み、 クリック セーブ接続は数秒以内に担当エージェントに到達します。

    テストは失敗しましたか? 通常は権限の不足、または間違った GA4 アカウントの認証情報が原因です。上記の手順では、 よくある問題 そして、それらの解決策。

  4. See your data in Query Builder オプション

    You can look at your GA4 account before Google Sheets is involved at all. Open クエリビルダー in the portal and pick the connection you just made. The スキーマ tab lists your tables and columns, and clicking one puts its name in the editor, so you can write a query without remembering exact names. Click 走る and the rows appear under 結果. Query Builder is on every plan, Free included.

    On Business plans you can also ask Nova in plain English (“show me customers in the USA”) and it writes the SQL for you. When the query looks right, save it: from Personal Core up it shows in the add-on’s Saved Queries list, and on any plan you can copy the SQL into the next step.

  5. Googleスプレッドシートにクエリストリームを追加する

    Google スプレッドシートを開き、 拡張機能 → アドオン → アドオンを入手、 検索する クエリストリーム、そしてクリック インストールまたは、直接インストールしてください。 Google Workspace Marketplace のクエリ ストリームGoogleはアドオンの許可を求めますが、これは正常な動作です。

    その後は、開くすべての Google スプレッドシートに表示されます。右側のサイド パネルにクエリ ストリーム アイコンが表示され、 拡張機能別途ログインする必要はありません。既にお使いのGoogleアカウントを認識するため、そのメールアドレスはQuery Streamsアカウントに登録されているものと同じである必要があります。

  6. 最初のテーブルを運び入れる

    シートの右側のサイドパネルにあるクエリ ストリーム アイコンをクリックします (または、以下で見つけます) 拡張機能)。 選ぶ クエリストリーマー そして、先ほど繋がった接続を選択してください。

    実行したいクエリを入力してください。これは、いくつかの列を抽出します。 ga4.トラフィック概要 テーブル:

    例:SQL
    SELECT date, sessions, total_users, screen_page_views FROM ga4.traffic_overview ORDER BY date DESC LIMIT 100;

    下 目的地一覧表 行を配置するタブを選択し、次にクリックします。 クエリーの実行データは1~2秒でそのタブに表示されます。データが変更された場合はいつでも「クエリの実行」を再度クリックすると、タブが即座に更新されます。

    SQLを知らない? Build it in クエリビルダー first and paste it here, or pick it from Saved Queries if you saved it.

それでおしまい。 データはシート内に保存され、ワンクリックで常に最新の状態に保たれます。お客様が要求した行以外は、ネットワークから外部に送信されることはありません。

良い次の動き

  • クエリを保存します ポータルにインストールすれば、Google スプレッドシートや Excel からワンクリックで再度実行できます。
  • フィルターを追加する 例えば日付範囲などを指定することで、同じクエリで編集せずに「今月」という回答を得ることができます。
  • 結果を共有する 同僚と共有する場合、同僚には行数が表示され、あなたの認証情報は表示されません。

人々が尋ねる質問

GA4アカウントは、私がスプレッドシートを使用するコンピューター上に存在する必要がありますか?

いいえ。エージェントはGA4アカウントと同じ場所にあれば十分です。Googleスプレッドシートはどのデバイスのブラウザでも動作します。同じGoogleアカウントでアドオンを開けば、接続情報が表示されます。

私のデータはクエリストリームにコピーされますか?

いいえ。エージェントはデータが存在する場所でクエリを実行し、返された行のみを送信します。その間に同期や保存は一切行われません。

無料プランで本当にこれがカバーされるのですか?

はい。無料プランは継続して利用できるプランで、期限切れのトライアルではありません。プランに含まれる内容については、 価格ページ.

シートは自動的に更新されますか?

最新の行を取得したい場合は、いつでも「クエリの実行」を再度クリックしてください。ユーザーが何も操作しなくてもスケジュールに基づいてシートが更新されるようにするには、クエリ ストリーム ポータル(ストリーム → 自動化)で自動化を設定します。これはすべてのプランに含まれています。

まだ行き詰まっていますか? 開く サポート クエリ ストリームで、どのステップで何が表示されているかをお知らせください。接続をご案内いたします。
クエリ ストリームは同じデータを接続しますエクセルクロード、カーソル、チャットGPTREST APIさらに

すべてのガイド GA4

あなたの設定とは少し違いますか?

  • クリック数やインプレッション数を増やして、あなたのサイトへのアクセス数を増やすGoogle検索を知りたいですか?Googleサーチコンソールならそれが可能です → Search Console

Setup trouble?

  • Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?
更新日 10月 17, 2026