お客さまへの大切なお知らせ：膨大なサポート情報を少しでも早くお客さまにお届けするため、本コンテンツの日本語版は人間の翻訳者を介さない自動翻訳で提供されております。

Google BigQueryでのHubSpotデータへのアクセス(ベータ版)

更新日時 2026年6月1日

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

Data Hub Enterprise

Google BigQueryをHubSpotアカウントに接続したら、 BigQueryでHubSpotデータを照会できます。

この記事では、BigQuery に同期される各テーブルのスキーマについて説明します。これを Google のドキュメントと併せて使用して、BigQuery アカウントの HubSpot データを照会できます。

データの概要

クエリーはSQLで構築され、以下のようなHubSpotのデータを取得することが可能です：

オブジェクト：コンタクト、会社、製品など、標準およびカスタムのオブジェクト。
レコード：個々のコンタクトや会社など、個々の記録。
関連付け: 利用可能なすべての関連付けタイプと現在関連付けられているレコード。
Eメール： Eメールの開封などHubSpotの標準的なイベントと、カスタムの行動イベントの両方のイベントデータです。

v1では異なるタイプのオブジェクトデータが結合されます:全てのオブジェクトタイプの全てのレコードが1つのデータベースオブジェクトに結合されます。したがって、照会時には、 “WHERE objectTypeId=’0-1’ のようなフィルターを指定する必要があります。

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

HubSpotのCRMデータモデルに関する詳細はこちらをご覧ください。

同期されたテーブルスキーマ

以下のセクションでは、構成された同期設定に基づいて HubSpot アカウントから BigQuery に同期される各テーブルのスキーマについて詳しく説明します。

object_propertiesスキーマ

以下のスキーマは、同期されたobject_propertiesテーブルの詳細を示しています。

列名	タイプ	説明
OBJECTTYPEID	文字列	オブジェクトタイプのID(例:コンタクトの場合は0-1)。
OBJECTID	INT64	レコードのID(例:コンタクトレコードの例として123752)。
NAME	文字列	プロパティーの名前。
VALUE	JSON	プロパティーの値
UPDATEDAT	タイムスタンプ	HubSpotでのレコードの最終更新日時。
INGESTEDAT	タイムスタンプ	レコードが BigQuery によって最後に取り込まれた日時。

object_with_object_propertiesスキーマ

以下のスキーマは、同期されたobject_with_object_propertiesテーブルの詳細を示しています。

列名	タイプ	説明
OBJECTTYPEID	文字列	オブジェクトタイプのID(例:コンタクトの場合は0-1)。
OBJECTID	INT64	レコードのID(例:コンタクトレコードの例として123752)。
PROPERTIES	JSON	レコードのプロパティー値
UPDATEDAT	タイムスタンプ	HubSpotでのレコードの最終更新日時。
INGESTEDAT	タイムスタンプ	レコードが BigQuery によって最後に取り込まれた日時。

associations_x_to_yスキーマ

以下のスキーマは、同期されたassociations_x_to_y_テーブルの詳細を示しています。

列名	タイプ	説明
COMBINEDASSOCIATIONTYPEID	文字列	特定の関連付け定義の固有ID。
関連付けカテゴリー	文字列	関連付けタイプの発生元。指定可能な値は、HUBSPOT_DEFINED、USER_DEFINED、INTEGRATOR_DEFINEDです。
ASSOCIATIONTYPEID (関連付けタイプID)	文字列	ASSOCIATIONCATEGORY内の関連付け定義の固有ID。このIDは、同じカテゴリー内の2つの定義で共有されません。
FROMOBJECTTYPEID	文字列	関連付けのソースオブジェクトのオブジェクトタイプID。
フロムオブジェクトタイプ	文字列	関連付けのソースオブジェクトタイプの名前。
TOOBJECTTYPEID	文字列	関連付けのターゲットオブジェクトのオブジェクトタイプID。
TOOBJECTTYPE	文字列	関連付けのターゲットオブジェクトタイプの名前。
NAME	文字列	関連付け定義の定義済み名。
LABEL	文字列	関連付け定義の説明的なラベル。
ISMAINASSOCIATIONDEFINITION	ブール	これがプライマリーの関連付けタイプ(true)であるかどうかを示します。これはHubSpotで関連付けられているレコードで表示されます。
[FROMOBJECTTYPE_OBJECTID]	INT64	ソースレコードのオブジェクトID。(例:ASSOCIATIONS_CONTACTS_TO_DEALSビューの場合はCONTACT_OBJECTID)。
[TOOBJECTTYPE_OBJECTID]	INT64	ターゲットレコードのオブジェクトID。(例:ASSOCIATIONS_CONTACTS_TO_DEALSビューの場合はDEAL_OBJECTID)。
INGESTEDAT	タイムスタンプ	レコードが BigQuery によって最後に取り込まれた日時。

association_definitionsスキーマ

以下のスキーマは、同期されたassociations_definitionsテーブルの詳細を示しています。

列名	タイプ	説明
COMBINEDASSOCIATIONTYPEID	文字列	特定の関連付け定義の固有ID。
関連付けカテゴリー	文字列	関連付けタイプの発生元。指定可能な値は、HUBSPOT_DEFINED、USER_DEFINED、INTEGRATOR_DEFINEDです。
ASSOCIATIONTYPEID (関連付けタイプID)	文字列	ASSOCIATIONCATEGORY内の関連付け定義の固有ID。このIDは、同じカテゴリー内の2つの定義で共有されません。
FROMOBJECTTYPEID	文字列	関連付けのソースオブジェクトのオブジェクトタイプID。
フロムオブジェクトタイプ	文字列	関連付けのソースオブジェクトタイプの名前。
TOOBJECTTYPEID	文字列	関連付けのターゲットオブジェクトのオブジェクトタイプID。
TOOBJECTTYPE	文字列	関連付けのターゲットオブジェクトタイプの名前。
NAME	文字列	関連付け定義の定義済み名。
LABEL	文字列	関連付け定義の説明的なラベル。
ISMAINASSOCIATIONDEFINITION	ブール	これがプライマリーの関連付けタイプ(true)であるかどうかを示します。これはHubSpotで関連付けられているレコードで表示されます。
INGESTEDAT	タイムスタンプ	レコードが BigQuery によって最後に取り込まれた日時。

イベント

イベントには、標準のHubSpotイベントとカスタム行動イベントがあります。各イベントには、それぞれデータベースオブジェクトがあり、ラベルは次のようになっています。events_eventname .

名前
イベント_広告_インタラクション	広告の詳細と、広告をクリックしたりフォームを送信したりして広告とインタラクションしたコンタクト。
イベント_広告_測定指標_インポート_v0	広告の詳細とそのパフォーマンス指標。
イベント_コール_キーワード	通話中に参加者が発言したキーワードの詳細。
イベント_clicked_link_in_email_v2	コンタクトがマーケティングメール内でクリックしたリンク。
イベント_クリックされたリンク_追跡された受信トレイ_メール_v8	コンタクトがConversations Inboxメール内でクリックしたリンク。
イベント_クッキー_バナークリック	Cookieをクリックしたコンタクト
イベント_クッキー_バナー_閲覧数	Cookieを閲覧したコンタクト
イベント_ドキュメント_共有_v2	外部リンクでコンタクトと共有される営業資料。
イベント_ドキュメント_ビューイング_v2	外部リンクを開いて表示した営業資料やコンタクト。
イベント_ドキュメント_完了_v2	営業文書とそれをクローズしたコンタクト。
イベント_hs_scheduled_email_v2	HubSpotのメールサーバーに送信されるEメール。
イベント_mta_delivered_email_v2	HubSpotのメールサーバーから受信者に正常に配信されたメール。
イベント_mta_bounced_email_v2	受信者のEメールサーバーによって拒否されたEメール配信の試み。
イベント_開封済み_メール_v2	コンタクト別のメール開封数
イベント_報告されたスパムメール_v2	受信者がスパムとしてマークしたEメール。
イベント_アップデイト_メール_配信登録状況_v2	受信者によるEメール配信登録の変更。
イベント_開封済み_追跡済み_受信トレイ_メール_v8	コンサベーション・受信トレイのメールをコンタクト別に開封。
イベント_mb_media_played	コンタクト別の動画再生アクティビティー。
events_v2_contact_booked_meeting_through_sequence	コンタクトは、シーケンスを通じてミーティングを予約しました。
イベント_v2_contact_enrolled_in_sequence	コンタクトは、順次登録されています。
イベント_v2_contact_finished_sequence	シーケンスは終了しました。
イベント_v2_contact_replied_sequence_email	シーケンスの送信メール（またはシーケンスの登録を解除した受信メール）に返信した担当者。
イベント_v2_contact_unenrolled_from_sequence	シーケンスから登録されていないコンタクト。
イベント_v2_contact_unenrolled_manually_from_sequence	ユーザーが手動でコンタクトを登録解除しました。
イベント_v2_contact_unsubscribed_sequence_email	コンタクトが配信登録を中止し、シーケンスが登録解除された。
イベント_v2_sequence_email_bounced	シーケンスメールがバウンス（不達）になった。
イベント_v2_sequence_errored	シーケンスエラーにより登録が解除されました。
events_v2_sequence_step_executed	シーケンスステップを実行した。
イベント訪問ページ	コンタクト別のウェブサイトページ訪問数。
EVENTS_ <INTEGRATION_EVENT_NAME>_ <UNIQUE_IDENTIFIER>	連携イベント(タイムラインV3 API)

イベントタイプIDとIDを組み合わせることで、イベントを識別できます。返される列はイベントによって異なります。イベントのプロパティーごとに1つの列が返されます。すべてのイベントで返される列を以下に示します。

列名	タイプ	説明
`EVENTTYPEID`	文字列	OBJECTTYPEID に似たイベントタイプの ID object_and_event_type_definitionsビューを使用して、アカウント内の全てのイベントタイプ ID をクエリーすることができます。
`ID`	文字列	これはイベントの種類ごとにユニークです。あるイベントタイプにおいて、同じIDを持つレコードは2つ存在しない。
`OBJECTTYPEID`	文字列	イベントを完了したオブジェクトのタイプ。例えば、メールのリンクのクリックの場合、この列にはコンタクトオブジェクトを表す`0-1` が表示されます。
`OBJECTID`	INT64	イベントを完了したレコードのID。
`OCCURREDAT`	タイムスタンプ	イベントが発生した時点。
`OCCURREDATDATEINT`	INT64	イベントが発生した時点を表す数字。と同じデータを含む。`OCCURREDAT`列で、数値としてフォーマットされ、テーブルのクラスターキーの一部として使用されます。たいていの場合は`OCCURREDAT`は、この数値の代わりにタイムスタンプを使用します。
`OCCUREDATDATEINT`	数	イベントが発生した時点を表す数字。と同じデータを含む。`OCCURREDAT`列で、数値としてフォーマットされ、テーブルのクラスターキーの一部として使用されます。たいていの場合は`OCCURREDAT`は、この数値の代わりにタイムスタンプを使用します。
`INGESTEDAT`	タイムスタンプ	データが BigQuery によって最後に取り込まれた日時。列のデータ型について詳細をご確認ください。
`PROPERTY_*`	Varchar	イベントのプロパティーを含む個々の列。

この記事はお役に立ちましたか？

こちらのフォームではドキュメントに関するご意見をご提供ください。HubSpotがご提供しているヘルプはこちらでご確認ください。

ベータGoogle BigQueryでのHubSpotデータへのアクセス(ベータ版)

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