カテゴリーを見る

Google Search ConsoleをGoogle Sheetsに接続する方法 - SQLでSEOデータを照会する

19分

0:00 22:40
Google Search Console と Google スプレッドシートを接続する

データ取得元 サーチコンソール の中へ グーグル シート

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

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

最終的に手に入るもの

Google Search Console のロゴGoogle スプレッドシートに、Search Console アカウントに対する SQL クエリのリアルタイム結果を表示し、データが変更されるたびに最新の行を取得するボタンを追加します。例：

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

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

必要なもの

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

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

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

バックグラウンドで動作し、Googleスプレッドシートから要求があった際にSearch Consoleを呼び出す小さなプログラムです。必要なのはインターネット接続だけです。

Search Consoleへのログイン

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

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

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

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

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

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

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

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

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

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

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

    ブラウザに戻って、 データエージェント （下 データ 上部メニューにあります。エージェントがそこに表示されています。クリックしてください。 コネクタを追加する そして選択する Googleサーチコンソール検索コンソールの認証情報が必要ですか？チュートリアルを開いて、以下を入力してください。

    Search Consoleの認証情報を作成する （約15分）

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

    誰がこれをできるのか
    Search Console: サービス アカウントをユーザーとして追加するには、プロパティの所有者 (確認済みまたは委任済み) である必要があります。 Google Cloud: プロジェクトの所有者 (作成するプロジェクトにはすべて所有者権限が付与されます)、またはプロジェクトに対して「サービス アカウントの作成」、「サービス アカウント キー管理者」、「サービス使用状況管理者」の各ロールが付与されている必要があります。
    推奨
    Google Cloud サービス アカウントの JSON キー (service_account タイプの .json ファイル)。サービス アカウントは Search Console プロパティで制限付きユーザーとして追加されています。

    始める前に

    • お客様のサイトは既にGoogleサーチコンソールに追加され、認証済みです。新規登録サイトの場合、Googleがデータを取得するまで最大1週間かかる場合があります。
    • その Search Console プロパティの所有者アクセス権が必要です。ユーザーを追加できるのは所有者のみです。フルユーザーまたは制限付きユーザーの場合は、Google Cloud の部分 (手順 1 ～ 12) を実行し、手順 13 ～ 17 は所有者に依頼してください。
    • Google Cloud プロジェクトを作成できる Google アカウント、または管理している既存のプロジェクトが必要です。会社の Google Cloud 組織が 2024 年 5 月 3 日以降に作成された場合、Google はデフォルトでキーのダウンロードをブロックするため、Google Cloud 管理者がキーのダウンロードを許可する必要がある場合があります (よくある問題を参照)。
    • 請求アカウントは不要です。GoogleはSearch Console APIの利用料を請求しません。
    • Query StreamsのGoogle Analytics 4コネクタをサービスアカウントで既に設定済みですか？それなら、その設定を再利用できます。同じプロジェクトでSearch Console APIを有効にし（手順4）、手順13に進み、そのサービスアカウントのメールアドレスを入力してください。同じJSONキーファイルが両方のコネクタに渡されます。
    • クエリ ストリーム ウィザードは、エージェントがオンラインの状態で別のタブ（データ エージェント → コネクタの追加 → Google Search Console）で開きます。

    手順

    1. Google Cloud でリソースを管理する

      Googleアカウントでサインインし、Google Cloudコンソールの「リソースの管理」ページを開いて、「プロジェクトの作成」をクリックします。

      Google Analytics 4 コネクタ用に作成したプロジェクトなど、使用したい Google Cloud プロジェクトが既にある場合は、手順 3 に進み、そこでプロジェクトを選択してください。Google Cloud を初めて開くと、ページが表示される前に、Google から国と利用規約への同意を求められる場合があります。

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

      「新規プロジェクト」ウィンドウで、「Query Streams Search Console」などのプロジェクト名を入力します。親組織またはフォルダの欄は、Googleが自動的に入力するままにしておきます。組織が表示されない場合は、そのままで問題ありません。「作成」をクリックします。

      プロジェクト名は4文字から30文字までです。使用できる文字は、英字、数字、スペース、ハイフン、シングルクォーテーション、感嘆符です。請求アカウントを選択する必要はありません。

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

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

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

    4. Google Search Console API を有効にする

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

      APIとサービス → ライブラリからもアクセスできます。Google Search Console APIを検索してください。Query Streamsでは使用しないIndexing APIやSite Verification APIは選択しないでください。GoogleがAPIが既に有効になっていると表示したら、手順5に進んでください。このAPIは、Query Streamsが読み取るすべての情報（プロパティリスト、サイトマップ、パフォーマンスデータ、URL検査）を網羅しています。

    5. サービスアカウント作成ページを開く

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

      Google Analytics 4コネクタのサービスアカウントを再利用する場合は、2つ目のアカウントを作成しないでください。そのプロジェクトで手順4を実行し、その後、そのメールアドレスを使用して手順13に進んでください。

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

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

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

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

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

      サービスアカウントに、ここでは所有者、編集者、閲覧者の権限を与えないでください。Search Console データへのアクセス権は、手順 16 で Search Console 内で付与されます。Google Cloud ロールは Search Console では何も機能せず、Google Cloud 内でキーが実行できる操作を拡張するだけです。

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

      最後のセクション（サービスアカウントのユーザーロールとサービスアカウントの管理者ロール）は空欄のままにして、「完了」をクリックしてください。サービスアカウント一覧画面に戻ります。

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

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

      .iam.gserviceaccount.com まで含めたアドレス全体をコピーしてください。同じアドレスが、手順12のキーファイルの client_email 行に含まれています。Googleによると、新しいサービスアカウントが使用可能になるまでには1分以上かかる場合があります。

    10. 「キー」タブを開く

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

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

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

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

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

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

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

    13. 検索コンソールを開いて物件を選択します

      サイトの所有者としてログインした状態で、Google Search Consoleを開きます。左上にあるプロパティのドロップダウンメニューから、クエリ ストリームで読み取るプロパティを選択します。

      サイトが2回記載されている場合、1回はドメイン名（example.com）として、もう1回はアドレス（https://www.example.com/）として記載されている場合、ドメイン名がドメインプロパティになります。ドメイン名はすべてのサブドメインとhttpおよびhttpsの両方をカバーするため、通常はドメイン名を選択します。

    14. ユーザーと権限を開く

      左側のメニューで下にスクロールし、「設定」をクリックします。次に、「ユーザーと権限」をクリックします。

      物件所有者のみが「ユーザーと権限」を確認できます。表示されていない場合は、あなたはフルユーザーまたは制限付きユーザーです。手順9で作成したメールを物件所有者に送信し、手順13～17を実行するよう依頼してください。

    15. 「ユーザーを追加」をクリック

      「ユーザーと権限」ページの右上にある「ユーザーの追加」をクリックします。「ユーザーの追加」ボックスが開きます。

    16. サービスアカウントのメールアドレスを入力し、「制限付き」を選択してください。

      手順9で取得したサービスアカウントのメールアドレスを「メールアドレス」に貼り付けます。権限リストを開き、「制限付き」を選択します。

      制限付きで十分です。Google では、制限付きユーザーがパフォーマンスを含むすべてのレポートを閲覧したり、URL 検査を使用したりすることができます。フルアクセスでも問題ありません。いずれの場合も、エージェントは Google に読み取り専用アクセスを要求するだけなので、サイトマップの送信、URL の削除、設定の変更はできません。

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

      「追加」をクリックします。サービスアカウントが、制限付き権限でプロパティのユーザーリストに表示されます。

      Search Console がアドレスを受け付けない場合（たとえば、メールアドレスが Google アカウントと一致しない、または見つからないと表示される場合）は、「よくある問題」を参照してください。Google では、2026 年 4 月以降、新規に作成されたサービス アカウントで既知の問題が発生しています。

    18. プロパティの書き方に注目してください

      プロパティのドロップダウンリストでプロパティ名を確認してください。example.com のような名前のみの場合はドメインプロパティです。sc-domain:example.com と入力します。https://www.example.com/ のような完全なアドレスの場合は URL プレフィックスプロパティです。http または https、www の有無、末尾のスラッシュを含め、表示されているとおりに正確に入力します。

      さらに簡単な方法として、クエリ ストリーム ウィザードの [検出] ボタンをクリックすると、正確な値が表示されます。プロパティが https://www.example.com/ であるにもかかわらず https://example.com/ と入力したり、最後のスラッシュを省略したりすると、サービス アカウントで読み取れないプロパティを指してしまいます。

    許可を与える

    リソースアクセス用途
    Search Consoleのユーザー権限（設定 → ユーザーと権限）制限付き（完全版でも可）すべての gsc テーブル: search_analytics (パフォーマンス データ: 日付、クエリ、ページ、国、デバイス別のクリック数、インプレッション数、CTR、掲載順位)、サイト、サイトマップ (すべてデフォルトで有効)、および url_inspection (デフォルトでは無効、必要に応じて実行)。Google では、制限付きユーザーがすべてのレポートを表示し、URL インスペクションを使用できるようにしています。
    Google Cloud API: Google Search Console API有効接続テスト、検出ボタン、およびすべてのgscテーブルを確認してください。これらがないと、Googleはすべての呼び出しに対して403エラーを返します。
    OAuthスコープ https://www.googleapis.com/auth/webmasters.readonlyエージェントからの依頼です（設定する必要はありません）すべての gsc テーブル、接続テスト、検出。Google はこのスコープを読み取り専用アクセスと説明しているため、エージェントはサイトマップを送信したり、URL を削除したり、設定を変更したりすることはできません。
    サービスアカウントの Google Cloud プロジェクトロールなしどのテーブルにも必要ありません。Search Consoleへのアクセスは、上記のユーザー権限によってのみ許可されます。
    Search Consoleの所有者（サービスアカウントではなく、設定を行う担当者）所有者（確認済みまたは委任済み）テーブルはありません。物件にユーザーを追加できるのは所有者のみです。

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

    サービスアカウントのJSONキー
    ステップ12で作成した.jsonファイル全体を使用します。ボックスの下にある「このコンピューターからアップロード」をクリックしてファイルを選択します（ファイルがエージェントコンピューターにある場合は、「エージェント上のファイルから…」を選択します）。または、メモ帳（Macの場合はTextEdit）でファイルを開き、すべてを選択してコピーし、最初の{から最後の}までを貼り付けます。後でコネクタを編集する場合は、このボックスを空白のままにして保存済みのキーを保持するか、新しいファイル全体を挿入して置き換えます。
    サイトプロパティURL
    キーを入力したら、ボックスの横にある「検出」をクリックします（エージェントがオンラインである必要があります）。ボックスには、サービス アカウントが参照できるすべてのプロパティのリストが表示されます。たとえば、sc-domain:example.com — siteRestrictedUser などです。該当するプロパティを選択してください。または、手順 18 で計算したとおりに、ドメイン プロパティの場合は sc-domain:example.com、URL プレフィックス プロパティの場合は、末尾にスラッシュが付いた完全なアドレス (例: https://www.example.com/) を入力します。

    よくある問題

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

    なぜ： このファイルはサービスアカウントキーではありません。通常は、OAuthクライアントファイル（client_secret_….jsonのような名前）か、APIとサービス → 認証情報にあるAPIキーです。

    修理： サービスアカウントにJSONキーを作成し（手順10～12）、そのファイルを使用します。サービスアカウントキーには、「type」:「service_account」という行が含まれます。

    接続テストが、無効な JSON フォーマット、またはサービス アカウント キーの 'private_key' フィールドの欠落または空のために失敗します。

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

    修理： 「このコンピューターからアップロード」をクリックし、コピーする代わりに.jsonファイルを選択してください。または、メモ帳（Macの場合はTextEdit）でファイルを再度開き、Ctrl+A（Macの場合はCmd+A）を押してコピーし、前後に何も入力せずに貼り付けてください。

    接続テストが失敗します。サービスアカウント「…」に検索コンソールのプロパティがない、または検出結果に「何も検出されませんでした」と表示されます。

    なぜ： Search Console はまだサービス アカウントをどのプロパティにも追加していません。手順 13 から 17 がスキップされたか、別のサイトで実行されたか、または Search Console がメールを拒否しました。

    修理： ステップ9で取得したメールアドレスを、プロパティのユーザーとして追加します（ステップ13～17）。ユーザーと権限に表示されていることを確認したら、もう一度「テスト」をクリックします。

    サービス アカウント '…' にはアクセス権がありません。Search Console プロパティに追加してください。というエラーで接続テストが失敗します。これは、サービス アカウントが「ユーザーと権限」にリストされている場合でも発生します。検出では、Google 独自のメッセージ「Google Search Console API は、プロジェクト … で以前に使用されたことがないか、無効になっています」が表示される場合があります。

    なぜ： キーが属する Google Cloud プロジェクト (キーファイルの project_id 行) では、Google Search Console API が有効になっていません。Google はこれらの呼び出しを 403 エラーで拒否し、テストではアクセス権限がないと報告されます。

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

    接続テストでは「接続済み」と表示されますが、gsc.search_analytics は空のままで、エージェントログには Search Analytics API エラー: Forbidden と表示されます。

    なぜ： サイトプロパティのURLが、サービスアカウントが追加されたプロパティと完全に一致していません。sc-domain: と https://、www と www なし、http と https、または最後のスラッシュが欠落している可能性があります。テストでは、サービスアカウントが少なくとも1つのプロパティを参照できるかどうかのみを確認します。同期処理では、入力したプロパティが読み取られます。

    修理： データエージェントでコネクタを開き、「編集」をクリックします。「サイトプロパティURL」の横にある「検出」をクリックし、リストからプロパティを選択して「接続テスト」をクリックし、「変更を保存」をクリックします。

    Search Consoleでサービスアカウントを追加できません。メールアドレスがGoogleアカウントと一致しない、または「ユーザーの追加に失敗しました：メールアドレスが見つかりません」というメッセージが表示されます。

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

    修理： スペースを入れずにアドレスを再度貼り付けてください。それでも拒否される場合は、数時間待ってから再度お試しください。以前に作成したサービスアカウントは通常有効です。サービスアカウントをお持ちの場合（例えば、Google Analytics 4コネクタから作成したアカウントなど）、そのメールアドレスを追加し、キーファイルを使用してください。

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

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

    修理： Google Cloud 管理者 (組織ポリシー管理者ロールを持つユーザー) に、このプロジェクトをポリシーの適用対象から除外するよう依頼してください。Google は、単一プロジェクトに対するタグベースの適用除外方法をドキュメントに記載しています。その後、手順 11 と 12 を繰り返してください。

    以前は正常に動作していたコネクタが同期を停止し、接続テストが「接続エラー: … invalid_grant … 無効な JWT 署名」で失敗します。

    なぜ： Google Cloud でキーが削除、無効化、または期限切れになりました。

    修理： 新しいキーを作成します（手順10～12）。データエージェントでコネクタを開き、「編集」をクリックして、新しいファイルを「サービスアカウントJSONキー」に配置し、「接続テスト」をクリックしてから「変更を保存」をクリックします。Google Cloudで古いキーを削除します。

    接続テストが、invalid_grant および Invalid JWT: トークンは有効期限の短いトークンである必要があります、というエラーで失敗します。

    なぜ： エージェントコンピュータの時計が数分ずれています。Googleは、時刻が間違っているコンピュータからのログインを拒否します。

    修理： エージェントコンピューターで自動（インターネット）時刻を有効にしてから、もう一度「テスト」をクリックしてください。

    gsc.search_analytics のクリック数とインプレッション数の合計は、Search Console のパフォーマンスチャートの値よりも少なくなります。

    なぜ： Googleは、行ごとの回答では稀な（匿名化された）クエリを除外しますが、グラフの合計値にはそれらも含まれます。また、Googleは各プロパティについて、検索タイプごとに1日あたり最大50,000行を返します。さらに、URLプレフィックスプロパティは、ドメインプロパティよりもサイトのカバー範囲が狭くなります。

    修理： 何も問題はありません。チャートの合計ではなく、Search Consoleのテーブルと行の合計を比較し、サイト全体を表示したい場合は「ドメイン」プロパティを選択してください。

    gsc.search_analyticsには、直近の2～3日分のデータが欠落しています。

    なぜ： Googleのデータは通常、事後2～3日後に準備が整います。エージェントは、本日より最大3日前までのGoogleの最終データのみを読み取ります。

    修理： 変更する必要はありません。それらの日付は後の同期で反映されます。各同期では過去5日間のデータも再読み込みされるため、後からの変更も反映されます。

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

    なぜ： コネクタを削除しても、Googleのアクセス権は削除されません。サービスアカウントはユーザーとして残り、キーも有効なままです。

    修理： Search Console → 設定 → ユーザーと権限で、サービス アカウントの横にあるメニューを開き、「アクセス権を削除」をクリックします。Google Cloud で、サービス アカウントの「キー」タブを開き、キーを削除します。次に、データ エージェントでコネクタを削除します。

    知るべき限界

    • 履歴：Search Consoleには過去16か月分の履歴が保存されます。エージェントの最初の同期では、過去16か月分の履歴がすべて読み込まれます。それ以前の日付の履歴はGoogleから取得できません。
    • 鮮度：Googleのデータは通常2～3日後に利用可能になります。エージェントは最終データのみを読み取り、最大で今日から3日前までのデータを読み取り、同期のたびに過去5日間のデータを再読み込みします。
    • 行数：Googleは、検索タイプごと、プロパティごとに、1日あたり最大50,000行を、クリック数順に返します。まれな（匿名化された）クエリは行として表示されないため、行の合計はSearch Consoleのグラフの合計よりも少なくなります。
    • 検索タイプ：ウェブ、画像、動画、ニュース、発見。それぞれsearch_type列に表示されます。発見行にはクエリやデバイス情報がありません。ニュース行にはクエリ情報がありません。
    • 割り当て: Search Analytics では、プロパティおよびユーザーごとに毎分 1,200 クエリ、Google Cloud プロジェクトごとに毎分 40,000 クエリ (1 日あたり 30,000,000 クエリ) が許可されており、さらに 10 分ごとおよび 1 日ごとの負荷制限が設けられています。ページとクエリごとにグループ化されたクエリは、長期間にわたる日付範囲で負荷が最も高くなるため、非常に大規模なサイトの最初の同期で割り当てを超える可能性があります。エージェントは、毎分 60 リクエストにペースを調整します。
    • URL検査：1日あたり2,000件、1分あたり600件の検査をプロパティごとに実施します。そのため、url_inspectionテーブルはデフォルトでは無効になっており、必要に応じてのみ実行されます。
    • 新規プロパティ：Googleは、新しく追加されたサイトに関するデータを生成するのに最大1週間かかる場合があります。
    • キー：サービスアカウントごとに最大10個のキーを設定できます。組織が最大有効期間を設定しない限り、キーはデフォルトでは期限切れになりません。
    • ユーザー：物件には、所有者以外のユーザーが最大100人まで登録できます。
    • 費用：GoogleはSearch Console APIの利用料を請求しません。

    手順は2026年10月8日に確認済み。出典： developers.google.com/webmaster-tools/v1/how-tos/authorizing, developers.google.com/webmaster-tools/v1/prereqs, developers.google.com/webmaster-tools/v1/sites, developers.google.com/webmaster-tools/v1/searchanalytics/…, developers.google.com/webmaster-tools/v1/how-tos/all-your…, developers.google.com/webmaster-tools/limits, developers.google.com/webmaster-tools/pricing, developers.google.com/search/blog/2022/10/performance-dat…, developers.google.com/search/blog/2018/06/new-url-inspect…, developers.google.com/identity/protocols/oauth2/service-a…, docs.cloud.google.com/resource-manager/docs/creating-mana…, docs.cloud.google.com/resource-manager/docs/access-contro…, docs.cloud.google.com/iam/docs/service-accounts-create, docs.cloud.google.com/iam/docs/keys-create-delete, docs.cloud.google.com/iam/docs/troubleshoot-org-policies, support.google.com/googleapi/answer/6158841?hl=en, support.google.com/webmasters/answer/7687615?hl=en, support.google.com/webmasters/answer/34592?hl=en, support.google.com/webmasters/answer/96568?hl=en, support.google.com/analytics/answer/10737381?hl=en, docs.airbyte.com/integrations/sources/google-search-console, help.imaginaire.co.uk/books/seo-tool/page/grant-access-to…, victorious.com/blog/google-search-console-add-user, seotesting.com/google-search-console/domain-vs-url-prefix, 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…, dev.to/morinaga/what-i-learned-debugging-gsc-url-inspecti….

    接続名
    後で必ず思い出すような名前、例えば「販売データベース」など。
    サービスアカウントのJSONキー
    Search Console プロパティにユーザーとして追加された Google サービス アカウントのキー ファイルの内容を貼り付けてください。
    サイトプロパティURL
    Search Consoleに表示されているとおりに、サイト名を正確に入力してください。例：sc-domain:example.com または https://example.com/。

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

    オープンデータエージェント

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

  4. クエリビルダーでデータを確認する オプション

    Google スプレッドシートが関わる前に、Search Console アカウントを確認できます。 クエリビルダー ポータルで、先ほど作成した接続を選択します。 スキーマ タブにはテーブルと列が表示され、いずれかをクリックするとその名前がエディタに表示されるため、正確な名前を覚えていなくてもクエリを作成できます。 走る そして行は以下に表示されます 結果クエリビルダーは、無料プランを含め、すべてのプランに含まれています。

    ビジネスプランでは、Novaに「アメリカの顧客を表示して」といった簡単な英語で質問すると、SQL文が自動的に生成されます。クエリが適切であれば保存してください。パーソナルコア以上のプランでは、アドオンの「保存済みクエリ」リストに表示され、どのプランでもSQL文を次のステップにコピーできます。

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

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

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

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

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

    実行したいクエリを入力してください。これは、いくつかの列を抽出します。 gsc.search_analytics テーブル：

    例：SQL
    SELECT date, query, clicks, impressions FROM gsc.search_analytics ORDER BY clicks DESC LIMIT 100;

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

    SQLを知らない？ 組み込む クエリビルダー まず、それをここに貼り付けるか、保存済みクエリの場合は「保存済みクエリ」から選択してください。

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

良い次の動き

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

人々が尋ねる質問

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

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

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

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

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

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

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

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

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

すべてのガイド Search Console

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

  • Google検索のクリック数ではなく、サイトへの訪問数、ユーザー数、コンバージョン数を重視しますか？Google Analytics 4は、GA4から直接日々のトラフィックテーブルを提供します → GA4

設定に問題がありますか？

  • エージェントがオフラインと表示される、または接続テストと参照がグレー表示されている場合？エージェントがオンラインであることを確認してください → エージェントはオンラインですか？
更新日 2026 年 10 月 17 日
グーグル・シート

あなたの気持ちは？

  • ハッピー
  • ノーマル
  • 悲しい

搭載 ベタードック