カテゴリーを見る

HubSpotをGoogle Sheetsに接続する方法 - SQLでCRMデータを照会する

17分で読めます

0:00 20:02
HubSpotとGoogleスプレッドシートを連携させる

データ取得元 ハブスポット の中へ グーグル シート

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

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

最終的に手に入るもの

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

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

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

必要なもの

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

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

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

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

HubSpotへのログイン

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

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

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

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

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

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

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

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

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

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

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

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

    HubSpotの認証情報を作成してください。 （約5分）

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

    誰がこれをできるのか
    スーパー管理者、または開発者ツールへのアクセス権限（サービスキー）を持つユーザー。従来のプライベートアプリにはスーパー管理者が必要です。
    推奨
    読み取り専用スコープを持つサービスキー（開発 → キー → サービスキー）。HubSpotは、BIツールやデータウェアハウスへの定期的なデータ同期にはサービスキーの使用を推奨しており、新しいレガシープライベートアプリを作成するオプションは廃止されます。

    始める前に

    • HubSpotのスーパー管理者アカウント、または開発者ツールへのアクセス権限を持つアカウントでログインする必要があります。サービスキーには、ご自身のHubSpotユーザーが既に持っているスコープのみを付与できます。
    • クエリを実行したいHubSpotアカウントを把握しておきましょう。キーは作成されたアカウントの情報しか読み取れないため、テストアカウントやサンドボックスアカウントではなく、そのアカウントで作成してください。
    • 使用するHubSpotテーブルを選択してください。連絡先、企業、取引、所有者、パイプライン、パイプラインステージ、プロパティはデフォルトで有効になっています。その他のテーブルにはそれぞれ読み取りスコープが必要です（「権限」を参照）。
    • Query Streams Agent が常時稼働しているコンピュータにインストールされ、オンラインになっていること、および Query Streams ポータルが別のタブで開いていること: データ エージェント → コネクタの追加 → HubSpot。

    手順

    1. HubSpotにサインインする

      HubSpotを新しいタブで開き、スーパー管理者として、または開発者ツールへのアクセス権限を持つユーザーとしてサインインしてください。

      複数のHubSpotアカウントをお持ちの場合は、続行する前に、データが必要なアカウントに切り替えてください。キーは、作成されたアカウントでのみ有効です。

    2. オープン開発

      左側のメインナビゲーションの下部付近にある「開発」（</>アイコン）をクリックします。開発ページが開き、概要、プロジェクト、レガシーアプリ、監視、キーなどを含む独自のサイドバーが表示されます。

      開発アイテムが見つかりません。お使いのHubSpotユーザーはスーパー管理者ではなく、開発者ツールへのアクセス権がありません。スーパー管理者にキーの作成、または権限の付与を依頼してください。

    3. オープンサービスキー

      開発サイドバーで、「キー」をクリックして展開し、「サービスキー」（ベータ版バッジが付いています）をクリックします。サービスキーのページが開きます。まだサービスキーが作成されていない場合は、「サービスキーが作成されていません」と表示されます。

      同じメニューのサービスキーのすぐ上にある個人アクセスキーや開発者APIキーは使用しないでください。これらは開発者ツールキーであり、接続できません。一部のアカウントでは、設定（歯車アイコン）→統合→サービスキーからこのページにアクセスできます。

    4. 「サービスキーの作成」をクリックします。

      サービスキーページの右上にある「サービスキーの作成」をクリックします。「サービスキーの作成」ページが開き、「名前」ボックスと「スコープ」セクションが表示されます。

    5. キーの名前を挙げてください

      「名前」には、後で識別しやすい名前を入力してください。例えば、「クエリ ストリーム読み取り専用」などです。HubSpot はこの名前をログに表示します。

      HubSpotアカウント内で、その名前は一意である必要があります。

    6. スコープピッカーを開く

      「選択したスコープ」の横にある「+ 新しいスコープを追加」をクリックします。右側に「スコープを検索」ボックスと各スコープのチェックボックスが表示されたパネルが開きます。

    7. 必要な4つのスコープにチェックを入れてください

      「スコープの検索」にそれぞれの名前を入力し、該当するチェックボックスをオンにします。crm.objects.contacts.read、crm.objects.companies.read、crm.objects.deals.read、crm.objects.owners.read。これら4つは、Query Streamsがデフォルトで同期するすべてのテーブルを網羅しています。

      .readで終わるスコープのみにチェックを入れてください。Query StreamsはHubSpotからデータを読み取るだけなので、.writeスコープは必要ありません。

    8. 追加テーブルのスコープにチェックを入れてください

      追加したいテーブルごとに、以下の権限リストから該当するスコープを選択してください。例：チケットの場合は crm.objects.tickets.read、明細項目、税金、割引、手数料の場合は crm.objects.line_items.read、リストの場合は crm.lists.read を選択してください。デフォルトのテーブルで十分な場合は、この手順をスキップしてください。

      新しいキーを作成しなくても、後からスコープを追加できます（キーを開いてから「編集」を選択してください）。

    9. 「更新」をクリックしてください。

      右側のパネルにある「更新」をクリックします。パネルが閉じ、選択したスコープが「選択されたスコープ」の下に表示されます。

    10. スコープリストを確認してください

      選択されたスコープを確認してください。末尾が「.write」で終わるものがあれば、その横にある「削除」をクリックしてください。キーが参照できる内容を分かりやすい言葉で一覧表示したい場合は、「選択されたスコープの概要」を展開してください。

    11. キーを作成する

      右上の「作成」をクリックし、開いたダイアログボックスで確認してください。

    12. 新しい鍵を開けてください

      「開発」→「キー」→「サービスキー」に進み、先ほど作成したキーの名前をクリックします。サービスキーボックスが表示された詳細ページが開きます。

    13. キーを表示してコピーする

      サービスキー欄の値は一部非表示になっており、pat- で始まります（例：pat-na1-…）。その下の「表示」をクリックし、次に「コピー」をクリックしてください。

      テキストを手動で選択するのではなく、「コピー」機能を使用してください。文字が欠落していたり、末尾にスペースがあったり、ドットが隠れていたりすると、テストが失敗します。HubSpotはキーを一度しか表示しません。戻ってきて「表示」を再度クリックすることができます。パスワードのように扱ってください。

    14. クエリ ストリームに貼り付けてテストしてください

      クエリ ストリーム ポータルでデータ エージェントを開き、「コネクタの追加」をクリックして HubSpot を選択します。キーを「アプリ アクセス トークン」に貼り付け、接続名を入力して、「接続テスト」をクリックします。結果には「接続済み」と表示されます。

      Query Streamsはエージェントのキーを保存し、HubSpotのデータのみを読み取ります。

    15. 表をスコープに合わせてください。

      次の同期ステップでは、ステップ7と8でスコープにチェックを入れたHubSpotテーブルのみを有効にしたまま、ウィザードを完了してください。

      スコープが設定されていないテーブルを有効にすると、「Forbidden」エラーが発生し、同期に失敗します。キーにスコープを追加するか（手順8）、テーブルを無効にしてください。

    代替案

    従来のプライベートアプリトークンを使用する

    お客様のアカウントには既に既存のプライベートアプリが存在しており、それを再利用したいと考えています。HubSpotは新規プライベートアプリの作成オプションを廃止します。2026年9月28日以降に作成されたアカウントは既に新規作成ができず、それ以前のアカウントは2026年10月26日に新規作成ができなくなります。既存のプライベートアプリとそのトークンは引き続きご利用いただけます。

    これを実行できるのは誰ですか？ スーパー管理者

    1. レガシーアプリを開く

      HubSpotでは、左側のメインナビゲーションで「開発」をクリックし、次に「開発」サイドバーで「レガシーアプリ」をクリックします。

      以前のHubSpotのナビゲーションでは、これは「設定」→「統合」→「プライベートアプリ」と呼ばれていました。

    2. プライベートアプリを開くか、新しいアプリを開始してください。

      アプリが一覧に表示されている場合は、その名前をクリックして手順6に進みます（スコープを追加する場合は手順5に進みます）。表示されていない場合、またはボタンがまだ表示されている場合は、右上の「レガシーアプリを作成」をクリックし、ダイアログボックスで「プライベート」を選択します。

      「レガシーアプリを作成」ボタンが表示されないということは、アカウントでの作成機能が既に無効になっていることを意味します。代わりにサービスキーを使用してください（主な手順）。

    3. 新しいアプリの名前を教えてください

      「基本情報」タブに、「クエリ ストリーム読み取り専用」などの名前を入力します。ロゴと説明は任意です。

    4. 読み取りスコープを追加する

      「スコープ」タブをクリックし、「新しいスコープを追加」をクリックします。手順7と8と同じスコープにチェックを入れ、「更新」をクリックします。次に、右上の「アプリを作成」をクリックし、ダイアログボックスに表示されるアクセストークンメッセージを読んで、「作成を続行」をクリックします。

    5. 既存のアプリにスコープを追加する（必要な場合のみ）

      アプリのページで右上の「アプリを編集」をクリックし、「スコープ」タブを開いて、不足している読み取りスコープを追加して保存します。スコープを変更してもトークン文字列は変わりません。

    6. トークンを表示してコピーする

      アプリのページで「認証」タブをクリックします。「アクセストークン」の下にある「トークンを表示」をクリックし、「コピー」をクリックします。トークンは「pat-」で始まります。メインの手順14と同様に、それを「アプリのアクセストークン」に貼り付けます。

      アプリを作成した HubSpot ユーザーが HubSpot から削除された場合、USER_DOES_NOT_HAVE_PERMISSIONS エラーで一部の呼び出しが失敗します。トークンを回転させて (トークンの横にある「回転」をクリック)、新しいトークンを貼り付けるか、サービス キーに移動してください。

    開発者プラットフォームアプリの静的認証トークンを使用する

    貴チームは既に、HubSpot CLI を使用して新しい開発者プラットフォーム上に HubSpot アプリを構築しており、静的認証とプライベート配信を設定済みです。アプリの構築には CLI が必要です。CLI をお持ちでない場合は、サービスキーを使用してください。

    これを実行できるのは誰ですか？ トークンを表示するにはスーパー管理者、または開発者シートを持つユーザーが必要です。アプリをインストールするにはスーパー管理者、またはHubSpot Marketplaceへのアクセス権限が必要です。

    1. プロジェクトを開く

      HubSpotで「開発」をクリックし、サイドバーの「プロジェクト」をクリックしてから、アプリが格納されているプロジェクトの名前をクリックします。

    2. アプリを開く

      プロジェクトの概要タブで、「プロジェクトコンポーネント」の下にあるアプリ名をクリックします。

    3. 配布タブを開く

      「配布」タブをクリックします。

    4. まだインストールしていない場合は、アプリをインストールしてください。

      「配信の管理」の下に、現在ご利用のHubSpotアカウントが表示されます。「今すぐインストール」をクリックし、要求されたアクセス権限が設定した読み取りスコープと一致していることを確認してから、「アプリを接続」をクリックしてください。

      静的トークンアプリは、一度に1つの標準HubSpotアカウントにのみインストールできます。

    5. トークンを表示してコピーする

      インストールが完了すると、「配布」タブにアクセストークンが表示されます。「表示」をクリックして表示させ、コピーして、メインの手順14と同様に「アプリアクセストークン」に貼り付けてください。

      後でアプリのスコープを変更した場合は、配布タブにある再インストールURLを使用して再インストールしてください。そうしないと、新しいスコープが適用されません。

    許可を与える

    リソースアクセス用途
    CRMオブジェクトの連絡先読み取り読む必須。hubspot.contacts、アクティビティ テーブル hubspot.calls、hubspot.emails、hubspot.meetings、hubspot.notes、hubspot.tasks、hubspot.communications (HubSpot のアクティビティ API はこのスコープを使用します)、および hubspot.properties と hubspot.associations の連絡先フィールド。
    crm.objects.companies.read読む必須。hubspot.companies、およびhubspot.propertiesとhubspot.associationsの会社フィールド。
    CRMオブジェクトの取引の読み取り読む必須。hubspot.deals、hubspot.pipelines および hubspot.pipeline_stages の取引パイプライン、hubspot.properties および hubspot.associations の取引フィールド。
    crm.objects.owners.read読む必須。hubspot.ownersはレコードを所有するHubSpotユーザーであり、取引や連絡先を担当者の名前に関連付けることができます。
    crm.objects.tickets.read読むチケット（hubspot.tickets）とチケットパイプライン（hubspot.pipelinesおよびhubspot.pipeline_stages）を同期する場合に限ります。古いアプリでは、代わりに従来のチケットスコープが表示される場合があり、そちらでも変更が可能です。
    crm.objects.products.read読む同期する製品の場合のみ：hubspot.products。ピッカーで製品を検索します。HubSpot の製品 API はこのスコープを受け入れますが、HubSpot のスコープ参照ページにはまだ記載されていません。
    crm.objects.line_items.read読むラインアイテム、税金、割引、または手数料を同期する場合のみ: hubspot.line_items、hubspot.taxes、hubspot.discounts、hubspot.fees。
    crm.objects.quotes.read読む引用を同期する場合のみ: hubspot.quotes。
    crm.objects.invoices.read読む請求書を同期する場合のみ: hubspot.invoices。
    crm.objects.subscriptions.read読むサブスクリプションを同期する場合のみ：hubspot.subscriptions（HubSpot Commerce サブスクリプション）。
    crm.objects.commercepayments.read読む支払いを同期する場合のみ: hubspot.payments (HubSpot Commerce Payments)。
    crm.objects.marketing_events.read読むマーケティング イベントを同期する場合のみ: hubspot.marketing_events。
    フォーム読み取りと書き込みが可能（HubSpotには読み取り専用フォームのスコープはありません）フォームまたはフォーム送信を同期する場合のみ、hubspot.forms と hubspot.form_submissions が使用されます。クエリ ストリームは、これらのファイルを読み取るだけです。
    crm.objects.feedback_submissions.read読むフィードバックを同期する場合のみ：hubspot.feedback_submissions。Service Hub Professional または Enterprise のみ。HubSpot のスコープ参照では crm.objects.feedback_submission.read と表記されているため、ピッカーで feedback を検索してください。
    crm.lists.read読むリストを同期する場合のみ: hubspot.lists。
    自動化読み取りと書き込みが可能（HubSpotには読み取り専用のワークフロー範囲はありません）ワークフローを同期する場合のみ利用可能です：hubspot.workflows。プロフェッショナルアカウントまたはエンタープライズアカウントのみ。クエリストリームはワークフロー定義のみを読み取ります。
    crm.schemas.custom.read読むカスタムスキーマ（hubspot.schemas、カスタムオブジェクト定義）を同期する場合のみ有効です。エンタープライズアカウントのみ対象です。

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

    アプリアクセストークン
    ステップ13でコピーしたサービスキー（pat-で始まる）、または従来のプライベートアプリトークン、または開発者プラットフォームアプリの静的認証トークン

    よくある問題

    新しいキーを貼り付けた直後に、接続テストが「無効または期限切れのアクセストークン」というエラーで失敗します。

    なぜ： この値はアプリキーやサービスキーではありません。よくある間違いは、開発 → キーの下にあるサービスキーの隣にあるパーソナルアクセスキーまたは開発者APIキーで、これらはHubSpotの開発者ツール用です。

    修理： 開発 → キー → サービスキーに移動し、キーを開いて「表示」をクリックし、「コピー」をクリックして、それをアプリアクセストークンに貼り付けます。接続を再度テストすると、「接続済み」と表示されます。

    ウィザードは、テストを行う前に「有効なHubSpotアプリトークンではありません」と表示します。

    なぜ： キーの一部しか貼り付けられていません。テキストは「pat-」で始まっておらず、非常に短いか、スペースが含まれています。

    修理： HubSpotに戻り、「表示」をクリックし、次に「コピー」リンクを使用します（テキストを手動で選択しないでください）。そして、再度貼り付けます。

    HubSpotの左側のナビゲーションに「開発」が表示されない、または「キー」の下に「サービスキー」が表示されない。

    なぜ： あなたのHubSpotユーザーはスーパー管理者ではなく、開発者ツールへのアクセス権限を持っていません。

    修理： 社内のスーパー管理者にキーを作成してもらい（手順2～13）、それをウィザードに貼り付けてもらうか、開発者ツールへのアクセス権を付与してもらうように依頼してください。

    接続テストでは「接続済み」と表示されますが、1つのテーブルが「アクセス禁止」エラーで同期に失敗するか、空のままになります。

    なぜ： 重要なのは、そのテーブルの読み取りスコープが設定されていないか、またはご利用のHubSpotプランにその機能が含まれていないことです（ワークフローにはProfessionalまたはEnterpriseプラン、カスタムスキーマにはEnterpriseプラン、フィードバックにはService Hub ProfessionalまたはEnterpriseプランが必要です）。

    修理： キーを開き（開発 → キー → サービスキー → キー名）、編集をクリックし、権限リストからスコープを追加して保存し、再度同期します。プランにこの機能が含まれていない場合は、接続の同期設定でそのテーブルをオフにしてください。

    以前は正常に動作していた同期処理が、「無効または期限切れのアクセストークン」というエラーで失敗し始める。

    なぜ： 誰かがキーをローテーションまたは削除しました。「ローテーションして期限切れにする」を選択すると、古いキーはすぐに無効になります。「ローテーションして期限切れにする」を選択すると、7日後に無効になります。

    修理： 開発 → キー → サービスキー → キー名 → 表示 → コピー から現在のキーをコピーします。データエージェントで HubSpot 接続を編集し、アプリアクセストークンに貼り付けて、接続テストを実行します。

    従来のプライベートアプリトークンを使用すると、一部のテーブルでUSER_DOES_NOT_HAVE_PERMISSIONSエラーが発生します。

    なぜ： プライベートアプリを作成したHubSpotユーザーは、アカウントから削除されました。

    修理： アプリのトークンをローテーションし（開発 → レガシーアプリ → アプリ → ローテーション）、新しいトークンを接続に貼り付けるか、代わりにサービスキーを作成してください。

    「レガシーアプリの作成」という項目が見つからないか、HubSpotのドキュメントでプライベートアプリがレガシーと呼ばれています。

    なぜ： HubSpotは、新しいレガシープライベートアプリの作成機能を廃止します（2026年9月28日以降に作成されたアカウントについては既に無効化済み、それ以前のアカウントについては2026年10月26日以降に無効化済み）。既存のプライベートアプリは引き続き動作します。

    修理： サービスキーを作成します（主な手順）。既存のプライベートアプリトークンはそのまま使用できます。

    クエリ ストリーム内のデータが、HubSpot で表示されるデータと一致しません。

    なぜ： そのキーは、別のHubSpotアカウント（例えば、テストアカウントやサンドボックスアカウント）で作成されました。

    修理： 適切なHubSpotアカウントに切り替えて、そこでキーを作成し、それを接続情報に貼り付けてください。

    知るべき限界

    • HubSpotのサービスキーとプライベートアプリの制限は、無料プランとスタータープランではキー1つあたり10秒ごとに100リクエスト、プロフェッショナルプランとエンタープライズプランでは190リクエスト、API制限増加アドオンを使用すると250リクエストとなっています。エージェントはこれらの制限のうち最も低い値に合わせて処理を進めるため、大規模なCRMの最初の完全同期には時間がかかる場合があります。
    • HubSpotアカウントごとの1日あたりのリクエスト制限は、無料プランとStarterプランでは25万件、Professionalプランでは62万5千件、Enterpriseプランでは100万件です。この制限はアカウント内のすべてのプライベートアプリとサービスキーで共有されるため、他の連携機能も同じ予算を使用します。
    • HubSpotのCRM検索は、エージェントが変更されたレコードのみを取得するために使用する機能であり、アカウントごとに1秒あたり5件のリクエスト、1クエリあたり最大10,000件の結果を許可しています。
    • 一部のテーブルは、HubSpotのプランによって異なります。ワークフロー（プロフェッショナルまたはエンタープライズ）、カスタムスキーマ（エンタープライズ）、フィードバック（サービスハブプロフェッショナルまたはエンタープライズ）。
    • サービスキーはパブリックベータ版（2026年2月10日より）のため、HubSpotは詳細を変更する可能性があります。HubSpotは、6か月ごとにキーを更新することを推奨しています。
    • 2026年9月28日以降に作成されたアカウント、および2026年10月26日以降に作成された古いアカウントでは、新しいレガシープライベートアプリを作成することはできません。既存のアプリとトークンは引き続き機能します。

    手順は2026年10月8日に確認済み。出典： developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/changelog/service-keys, developers.hubspot.com/blog/hubspot-service-keys-the-righ…, developers.hubspot.com/changelog/legacy-private-app-creat…, developers.hubspot.com/docs/apps/legacy-apps/private-apps…, developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/docs/getting-started/developer-ove…, developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/docs/developer-tooling/platform/us…, developers.hubspot.com/docs/api-reference/latest/crm/sear…, knowledge.hubspot.com/user-management/hubspot-user-permis…, developers.hubspot.com/docs/api-reference/legacy/crm/obje…, developers.hubspot.com/docs/api-reference/legacy/crm/acti…, developers.hubspot.com/docs/api-reference/legacy/crm/acti…, developers.hubspot.com/docs/api-reference/legacy/crm/obje…, developers.hubspot.com/docs/api-reference/legacy/crm/obje…, developers.hubspot.com/docs/api-reference/legacy/crm/pipe…, developers.hubspot.com/docs/api-reference/legacy/crm/obje…, developers.hubspot.com/docs/api-reference/legacy/automati…, developers.hubspot.com/docs/api-reference/legacy/marketin…, developers.hubspot.com/docs/api-reference/legacy/account/…, docs.n8n.io/integrations/builtin/credentials/hubspot.

    接続名
    後で必ず思い出すような名前、例えば「販売データベース」など。
    アプリアクセストークン
    HubSpotプライベートアプリトークン（pat-で始まります）は、[設定]、[統合]、[プライベートアプリ]、[アプリ]、[認証]タブにあります。

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

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

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

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

    You can look at your HubSpot 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. 最初のテーブルを運び入れる

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

    実行したいクエリを入力してください。これは、いくつかの列を抽出します。 ハブスポット・ディールズ テーブル：

    例：SQL
    SELECT dealname, dealstage, amount, closedate FROM hubspot.deals ORDER BY closedate 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 からワンクリックで再度実行できます。
  • フィルターを追加する 例えば日付範囲などを指定することで、同じクエリで編集せずに「今月」という回答を得ることができます。
  • 結果を共有する 同僚と共有する場合、同僚には行数が表示され、あなたの認証情報は表示されません。

人々が尋ねる質問

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

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

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

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

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

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

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

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

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

すべてのガイド HubSpot

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
グーグル・シート

あなたの気持ちは？

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

搭載 ベタードック