メインコンテンツにスキップ
HubSpot ナレッジベース
お客さまへの大切なお知らせ：膨大なサポート情報を少しでも早くお客さまにお届けするため、本コンテンツの日本語版は人間の翻訳者を介さない自動翻訳で提供されております。正確な最新情報については本コンテンツの英語版をご覧ください。

HubSpotとGoogle BigQueryを接続する

更新日時 2025年7月17日

以下の 製品でご利用いただけます（別途記載されている場合を除きます）。

HubSpotとGoogle BigQueryを接続して、HubSpotのデータをGoogle BigQueryインスタンスに同期する方法をご紹介します。 

注：HubSpotがHIPAAデータをGoogle BigQueryと共有することはありません。

HubSpotとBigQueryを接続する

HubSpotとGoogle BigQueryを接続するには、以下の手順を順番に行う必要があります。

  1. HubSpotアプリマーケットプレイスからGoogle BigQueryをインストールする
  2. Google Cloud PlatformでカスタムIAMロールを作成する
  3. Googleサービスアカウントにカスタムロールを割り当てる
  4. HubSpotによって生成されたGoogle BigQueryアカウントに、BigQueryテーブルの変更権限を付与する
  5. HubSpotで設定を完了する

1. HubSpotアプリマーケットプレイスからGoogle BigQueryをインストールする

HubSpotとGoogle BigQueryを接続するときは、HubSpotアカウントとGoogle BigQueryアカウントをそれぞれ別のタブで開いておくことをお勧めします。 

  1. ご利用のHubSpotアカウントが、「Google BigQueryでHubSpotデータにアクセス」のベータ版にオプトインされていることを確認します。 
  2. こちらのリンクに移動して、ご利用のHubSpotアカウントを選択します。 
  3. 右上の［アプリをインストール］をクリックします。
  4. ［バケットURI］と［プロジェクトID］に値を入力します。 
  5. ［次へ］をクリックします。 

HubSpotのデータをBigQueryに接続するためにバケットURIとプロジェクトIDを入力するページのスクリーンショット

  1. GoogleサービスアカウントとBigQueryアカウントを確認し、メモしておきます。これらの値は、次の手順で必要になります。アカウントの値をメモしたら、Google Cloudコンソールに移動して次の手順に従います。 

サービスアカウントに権限を付与する場所を示すスクリーンショット

2. Google Cloud PlatformでカスタムIAMロールを作成する

  1. Google Cloudコンソールにログインします。 
  2. 左側にあるナビゲーションメニューをクリックし、［IAMと管理］＞［ロール］を選択します。 
  3. 上部の［ロールを作成］をクリックします。
  4. ロールのタイトル、説明（省略可）、IDを入力します。 
  5. ［権限を追加］をクリックします。 

Google CloudでIAMロールを作成するページを示すスクリーンショット

  1. テーブルで以下の権限を選択し、［追加］をクリックします。

bigquery.datasets.create
bigquery.datasets.get
bigquery.datasets.getIamPolicy
bigquery.jobs.create
bigquery.tables.create
bigquery.tables.createIndex
bigquery.tables.createSnapshot
bigquery.tables.createTagBinding
bigquery.tables.delete
bigquery.tables.deleteIndex
bigquery.tables.deleteSnapshot
bigquery.tables.update
bigquery.tables.get
storage.buckets.get
storage.objects.create
storage.objects.delete
storage.objects.get
storage.objects.list

  1. ［作成］をクリックします。 

3. GoogleサービスアカウントにCloud Storageバケットへのアクセス権限を付与する

  1. 左側にあるナビゲーションメニューをクリックし、［Cloud Storage］＞［バケット］を選択します。 
  2. バケットを選択し、設定します。 
  3. ［権限］タブをクリックします。
  4. ［プリンシパル別に表示］タブで、［アクセスを許可］をクリックします。

GoogleサービスアカウントにCloud Storageバケットへのアクセス権限を付与するページのスクリーンショット

  1. 右側のパネルにある［新しいプリンシパル］フィールドに、手順1で作成したGoogleサービスアカウントの名前を入力します。

注：BigQueryアカウントではなく、必ずGoogleサービスアカウントを割り当ててください。

  1. ［ロールの割り当て］セクションでドロップダウンメニューをクリックし、［カスタム］＞［<role>］を選択します。ここで、<role>は手順2で作成したカスタムIAMロールです。 
  2. ［保存］をクリックします。これで、Googleサービスアカウントが［Storageオブジェクト閲覧者］ロールに追加されます。 

4. HubSpotによって生成されたGoogle BigQueryアカウントに、BigQueryテーブルの変更権限を付与する

  1. 左側にあるナビゲーションメニューをクリックし、［IAMと管理］＞［IAM］を選択します。 
  2. ［アクセスを許可］をクリックします。
  3. 右側のパネルの［新しいプリンシパル］フィールドに、手順1でHubSpotによって生成されたGoogle BigQueryアカウントを入力します。
  4. ［ロールの割り当て］セクションでドロップダウンメニューをクリックし、［カスタム］＞［<role>］を選択します。ここで、<role>は手順2で作成したカスタムIAMロールです。 

5. HubSpotで設定を完了する

  1. HubSpotアカウントで、［接続されたアプリに移動する］をクリックします。 

HubSpotアカウントで設定を完了する方法を示すスクリーンショット。

  1. 表示されるダイアログボックスで、チェックボックスをオンにしてから、［許可してインストール］をクリックします。 

HubSpotとGoogle BigQuery間で同期するデータの形式

同期できるデータ

HubSpotからGoogle BigQueryに同期できるデータは次のとおりです。 

  • オブジェクト：標準オブジェクトとカスタムオブジェクト（コンタクト、会社、チケット、製品など）。
  • レコード：個々のオブジェクトレコード。 
  • 関連付け：全ての関連付けタイプと、関連付けられているレコード。
  • イベント：標準のHubSpotイベントとカスタム行動イベントの両方に関するイベントデータ。 
  • リスト：HubSpotのコンタクトリストと会社リスト。
  • 担当者：レコード担当者。 
  • パイプライン：取引パイプラインとチケットパイプラインおよびパイプラインステージ。 
  • プロパティー：オブジェクトレコードのプロパティーとそれぞれの値（プロパティー履歴を含む）。 

各種のオブジェクトデータは、次の2つの方法で整理されて使用可能になります。

  • 個別：各オブジェクトタイプがそれぞれに固有のテーブルに格納されます。各テーブルには、同じオブジェクトタイプのレコードのみが含まれます。例えば、objects_contactsにはコンタクトレコードのみが含まれます。
  • 結合：全てのオブジェクトタイプのレコードが1つのデータベースオブジェクトに結合されます。したがって、クエリーを実行するときには、「WHERE objectTypeId='0-1'」のようなフィルターを指定する必要があります。

カスタムオブジェクトには作成時にIDが割り当てられ、「2-unique_ID」として識別されます。例えば、「2-12345」となります。 

objects_xテーブル

利用可能なオブジェクトタイプ（カスタムオブジェクトを含む）ごとに、それぞれ固有のテーブルがあります。これらのテーブルには、OBJECTS_<object type name>の形式で名前が付けられます。ここで、<object type name>はobjecttypeの複数形のラベルです（オブジェクトタイプに複数形がない場合、<object type name>はオブジェクトタイプ名の単数形に「S」を連結したラベルになります）。

下の表に、使用可能なHubSpotオブジェクトタイプの全リストと、各タイプが表すデータの簡単な説明を記載します。その後、それぞれに対応するテーブルについて説明します。

HubSpotオブジェクトタイプ

ObjectTypeId

説明

CONTACT

0～1

貴社と取引している個人に関する情報

COMPANY

0～2

個々の企業や組織に関する情報

DEAL

0～3

コンタクトや会社との収益機会に関する詳細 

ENGAGEMENT

0～4

CRMアクション（メモ、タスク、Eメール、ミーティング、コールなど）によるデータが格納されます。

TICKET

0～5

顧客からのサポートリクエストを表します。

QUOTE

0～14

購入を検討している見込み客と価格情報を提供するために使用されます。

FORM_SUBMISSION

0～15

個別のHubSpotフォーム送信に関する詳細

LINE_ITEM

0～8

取引において販売する製品のサブセットを表します。製品は、取引に関連付けられると商品項目になります。

CONVERSATION

0～11

さまざまなチャンネルから受信したメッセージに関する詳細

LANDING_PAGE

0～25

ランディングページに関する詳細

 TASK

0～27

ToDoリストに関する情報が格納されます。

FORM

0～28

訪問者やコンタクトのリード情報を収集するために使用されます。

MARKETING_EMAIL

0～29

Marketing Hubから送信されたEメールに関する詳細

AD_ACCOUNT

0～30

Linkedin、Facebook、Googleの広告アカウントに関する情報が格納されます。

AD_CAMPAIGN

0～31

広告キャンペーンに関する詳細。広告キャンペーンには、1つまたは複数の広告が含まれることがあります。

AD_GROUP

0～32

広告キャンペーンに含まれている広告の論理的なグループ化

AD

0～33

個々の広告に関する詳細

CAMPAIGN

0～35

関連するマーケティングアセットやコンテンツに関する情報。この情報を基に、全体的なマーケティング活動の有効性を容易に評価できます。

SITE_PAGE

0～38

ウェブサイト上の個々のページに関するデータ

BLOG_POST

0～39

ブログ記事に関するデータ

OBJECT LIST

0～45

プロパティーまたはアクティビティーを基準としたオブジェクトレコードのグループ化に関する情報

CALL

0～48

他のCRMレコード（例えばコンタクトなど）から発信された通話

INVOICE

0～53

請求書を管理し、外部会計システムと同期します。

MEDIA_BRIDGE

0～57

HubSpotにインポートされたメディアアセットに関する情報

SEQUENCE

0～58

シーケンスとは、コンタクトを長期的に育成するための、ターゲットを絞った一連のメールテンプレートのことです。

DEAL_SPLIT

0～72

取引分割は、複数のユーザー間で取引クレジットを共有するために使用されます。

SALES_DOCUMENT

0～83

チーム全体でセールスドキュメントをアップロードしてコンテンツライブラリーを構築し、コンタクトと共有します。

FEEDBACK_SUBMISSION

0～19

フィードバックアンケートに対して送信された情報が格納されます。

SUBSCRIPTION

0～69

配信登録には、定期的な支払いの詳細が格納されます。

COMMERCE PAYMENT

0～101

お客さまからお預かりした資金のデータが格納されます。

object_with_object_properties

このテーブルにはHubSpotレコードのデータが格納されます。オブジェクトタイプに含まれるレコードごとに1行を取得できます（例：コンタクト オブジェクト タイプに含まれる全てのコンタクトレコード）。 

object_properties_history

このテーブルには過去のプロパティー値が格納されます。コンタクトの場合、直近の45個の値が格納されます。その他全てのオブジェクトでは、直近の20個の値が格納されます。このテーブルには、過去のプロパティー値ごとの行があります。プロパティーの現在の値は、プロパティーの履歴における最新の「UPDATEDAT」タイムスタンプで示されます。

関連付けクエリー

オブジェクトデータと同様に、関連付けデータも2つの方法で整理されます。

  • 個別：各関連付けタイプがそれぞれに固有のテーブルに格納されます。各テーブルには、同じ関連付けタイプのレコードのみが含まれます。例えば、associations_contacts_to_dealsには、コンタクトオブジェクトと取引オブジェクトとの関連付けレコードのみが格納されます。T
  • 結合：全ての関連付けタイプのレコードが1つのテーブルに結合されます。

associations_x_to_y 

関連付けタイプごとに、associations_<association type name>としてラベル付けされた固有のビューがあります（例：associations_contacts_to_deals）。 

association_definitions

このテーブルには、HubSpotオブジェクト間で利用可能な全ての関連付けタイプに関する情報が、関連付けタイプごとに1行ずつ表示されます。

property_definitions

このテーブルには、HubSpotアカウントのオブジェクトプロパティーとイベントプロパティーに関する情報が格納されます。イベントプロパティーには、メールの開封やクリックなどの標準イベントプロパティーと、カスタム行動イベントプロパティーがあります。この情報は、object_propertiesおよびイベントデータに含まれる値を定義する際に役立ちます。

イベント

イベントには、標準のHubSpotイベントとカスタム行動イベントがあります。イベントごとに、events_eventnameとしてラベル付けされた固有のテーブルがあります。

object_and_event_type_definitions

このテーブルには、HubSpotアカウントで使用できる全てのオブジェクトとイベントの定義が格納されます。

同期の頻度とデータの編成

HubSpotとGoogle BigQuery間のデータ同期は毎日0600 UTC +0に開始されます。データの同期日ごとのフォルダーが作成されます。これらのフォルダー内には、テーブルごとにサブフォルダーが作成されます。Google Cloudプラットフォームでは、直近7回の同期に対応するフォルダーを使用できます。BigQueryのテーブルは、最新のバケットダンプを指すように更新されます。

次の各テーブルは、Parquet形式のファイルとして使用できます。

ASSOCIATIONS
ASSOCIATION_DEFINITIONS
EVENTS_[Event name]
LISTS
LIST_MEMBERSHIPS
OBJECTS
OBJECT_AND_EVENT_TYPE_DEFINITIONS
OBJECT_PROPERTIES
OBJECT_PROPERTIES_HISTORY
OBJECT_WITH_OBJECT_PROPERTIES
OWNERS
OWNER_TEAM
PIPELINES
PIPELINE_STAGES
PROPERTY_DEFINITIONS
TEAMS
この記事はお役に立ちましたか？
こちらのフォームではドキュメントに関するご意見をご提供ください。HubSpotがご提供しているヘルプはこちらでご確認ください。
目次 メニュー

関連記事

New to HubSpot? Use these guides to get started.