請注意：：這篇文章的翻譯只是為了方便而提供。譯文透過翻譯軟體自動建立，可能沒有經過校對。因此，這篇文章的英文版本應該是包含最新資訊的管理版本。你可以在這裡存取這些內容。

在 Google BigQuery 中存取 HubSpot 資料（測試版）

上次更新時間： 2026年6月30日

可搭配下列任何訂閱使用，除非另有註明：

Data Hub Enterprise

將 Google BigQuery 連接到您的 HubSpot 帳戶後，您便可在 BigQuery 中查詢 HubSpot 資料。

本文提供同步至 BigQuery 的各張資料表之資料結構資訊，您可配合Google 的文件，藉此在您的 BigQuery 帳戶中查詢 HubSpot 資料。

資料概覽

查詢是透過 SQL 建構的，可用於擷取以下類型的 HubSpot 資料：

物件：標準 與自訂物件，例如聯絡人、公司、產品。
記錄：個別 記錄，例如單一聯絡人或公司。
關聯：所有可用的關聯類型以及目前已關聯的記錄。
事件：包含標準 HubSpot 事件（例如電子郵件開啟）及自訂行為事件的相關資料。

v1 版本會將不同類型的物件資料合併：所有物件類型的所有記錄都會合併為一個資料庫物件。因此，在執行查詢時，您需要指定類似「WHERE objectTypeId=’0-1’」的篩選條件。

自訂物件在建立時會被指派一個 ID，並以2-unique_ID 的形式標示。例如：2-12345。

進一步了解 HubSpot 的 CRM 資料模型。

同步的資料表結構

以下各節將根據您所設定的同步設定，詳細說明從您的 HubSpot 帳戶同步至 BigQuery 的各資料表之結構。

object_properties 結構

以下結構說明詳列了已同步的 object_properties 資料表：

欄位名稱	類型	描述
OBJECTTYPEID	字串	物件類型的 ID（例如，聯絡人的 ID 為 0-1）。
OBJECTID	INT64	該記錄的 ID（例如，123752 為一個聯絡人記錄的範例）。
NAME	STRING	屬性的名稱。
VALUE	JSON	屬性的值
更新日期	TIMESTAMP	該記錄在 HubSpot 中最後一次更新的日期與時間。
INGESTEDAT	時間戳記	該記錄最後由 BigQuery 匯入的日期與時間。

object_with_object_properties 結構

以下結構說明提供了已同步的 object_with_object_properties 資料表的詳細資訊：

欄位名稱	類型	描述
OBJECTTYPEID	字串	物件類型的 ID（例如，聯絡人的 ID 為 0-1）。
OBJECTID	INT64	該記錄的 ID（例如，123752 為一個聯絡人記錄的範例）。
PROPERTIES	JSON	該記錄的屬性值
UPDATEDAT	TIMESTAMP	該記錄在 HubSpot 中最後一次更新的日期與時間。
INGESTEDAT	時間戳記	該記錄最後由 BigQuery 匯入的日期與時間。

associations 資料結構

以下架構提供已同步的 associations 資料表的詳細資訊：

欄位名稱	類型	描述
COMBINEDASSOCIATIONTYPEID	字串	關聯定義的唯一識別碼。
來源物件 ID	INT64	來源物件的 ID。
TOOBJECTID	INT64	目標物件的 ID。
INGESTEDAT	TIMESTAMP	BigQuery 最後一次匯入該記錄的日期與時間。

association_definitions 資料結構

以下架構提供已同步的 associations_definitions 資料表的詳細資訊：

欄位名稱	類型	描述
COMBINEDASSOCIATIONTYPEID	字串	特定關聯定義的唯一識別碼。
關聯類別	字串	關聯類型的來源。可能的值包括：HUBSPOT_DEFINED、USER_DEFINED 或 INTEGRATOR_DEFINED。
關聯類型 ID	字串	在該「關聯類別」內，關聯定義的唯一識別碼。同一類別中不會有兩個定義共用此識別碼。
來源物件類型識別碼	字串	關聯的來源物件之物件類型識別碼。
來源物件類型	字串	關聯的來源物件類型的名稱。
目標物件類型 ID	字串	關聯目標物件的物件類型 ID。
TOOBJECTTYPE	字串	關聯的目標物件類型的名稱。
NAME	字串	關聯定義的已定義名稱。
標籤	字串	關聯定義的描述性標籤。
ISMAINASSOCIATIONDEFINITION	布林值	指示此是否為主關聯類型（true），即 HubSpot 會在關聯記錄上顯示的類型。
INGESTEDAT	時間戳記	BigQuery 最後一次匯入該記錄的日期與時間。

事件

事件包含標準的 HubSpot 事件以及自訂行為事件。每個事件都有其專屬的資料庫物件，標籤為events_eventname。

姓名
EVENTS_AD_INTERACTION	廣告的詳細資訊，以及透過點擊廣告或在與廣告互動後提交表單而與該廣告產生互動的聯絡人。
EVENTS_AD_METRICS_IMPORTED_V0	廣告的詳細資訊及其成效指標。
EVENTS_CALL_MENTIONED_KEYWORD	通話中任何參與者提及的關鍵字詳情。
EVENTS_CLICKED_LINK_IN_EMAIL_V2	聯絡人在行銷電子郵件中點擊的連結。
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	聯絡人在「對話」收件匣電子郵件中點擊的連結。
EVENTS_COOKIE_BANNER_CLICKED	點擊過 Cookie 橫幅的聯絡人。
EVENTS_COOKIE_BANNER_VIEWED	瀏覽過 Cookie 通知橫幅的聯絡人。
EVENTS_DOCUMENT_SHARED_V2	透過外部連結與聯絡人分享的銷售文件。
EVENTS_DOCUMENT_VIEWED_V2	透過開啟外部連結而由聯絡人瀏覽過的銷售文件。
EVENTS_DOCUMENT_COMPLETED_V2	已結案的銷售文件及其對應的聯絡人。
EVENTS_HS_SCHEDULED_EMAIL_V2	已提交至 HubSpot 電子郵件伺服器待發送的電子郵件。
EVENTS_MTA_DELIVERED_EMAIL_V2	已由 HubSpot 電子郵件伺服器成功送達收件人的電子郵件。
EVENTS_MTA_BOUNCED_EMAIL_V2	被收件人電子郵件伺服器拒絕的郵件傳送嘗試。
EVENTS_OPENED_EMAIL_V2	聯絡人開啟電子郵件的次數。
EVENTS_REPORTED_SPAM_EMAIL_V2	被收件人標記為垃圾郵件的電子郵件。
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	收件人對電子郵件訂閱狀態所做的變更。
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8	聯絡人開啟「收件匣」中追蹤電子郵件的紀錄。
EVENTS_MB_MEDIA_PLAYED	聯絡人播放影片的活動紀錄。
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	聯絡人透過序列預約了會議。
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	聯絡人已從流程中註冊。
EVENTS_V2_CONTACT_FINISHED_SEQUENCE	序列已完成。
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	聯絡人回覆了透過序列發送的電子郵件（或導致退出序列的來信）。
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE	聯絡人已從序列中取消訂閱。
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE	使用者手動將該聯絡人從序列中取消訂閱。
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL	聯絡人已取消訂閱，並從序列中移除。
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	序列電子郵件遭退件。
EVENTS_V2_SEQUENCE_ERRORED	序列發生錯誤，導致取消訂閱。
EVENTS_V2_SEQUENCE_STEP_EXECUTED	序列步驟已執行。
EVENTS_VISITED_PAGE	聯絡人瀏覽網站頁面的紀錄。
EVENTS_<整合事件名稱>_<唯一識別碼>	整合事件（Timeline V3 API）

您可以透過結合事件類型 ID 與 ID 來識別事件。回傳的欄位取決於事件本身，每個事件屬性對應一個欄位。所有事件都會回傳以下欄位：

欄位名稱	類型	描述
`EVENTTYPEID`	字串	事件類型的 ID，類似於 OBJECTTYPEID 您可以使用object_and_event_type_definitions檢視表查詢您帳戶中的所有事件類型 ID。
`ID`	字串	此 ID 針對每個事件類型皆為唯一。在特定事件類型內，不會有兩筆記錄擁有相同的 ID。
`OBJECTTYPEID`	字串	觸發該事件的物件類型。例如，電子郵件連結點擊事件在此欄位中會顯示`0-1`代表「聯絡人」物件。
`OBJECTID`	INT64	完成該事件的記錄之 ID。
`OCCURREDAT`	TIMESTAMP	事件發生的時間。
`OCCURREDATDATEINT`	INT64	一個代表事件發生時間的數字。其資料內容與`OCCURREDAT`欄位相同，但以數字格式呈現，並用作該表叢集鍵的一部分。在大多數情況下，您可以使用`OCCURREDAT`時間戳記來取代此數字。
`OCCUREDATDATEINT`	數字	代表事件發生時間的數值。其內容與`OCCURREDAT`欄位相同，但以數值格式呈現，並用作該資料表叢集金鑰的一部分。在大多數情況下，您可以使用`OCCURREDAT`時間戳記來取代此數值。
`INGESTEDAT`	時間戳記	BigQuery 最後一次匯入資料的日期與時間。進一步了解欄位資料類型。
`PROPERTY_*`	Varchar	包含事件屬性的個別欄位。

這篇文章有幫助嗎？

此表單僅供記載意見回饋。了解如何取得 HubSpot 的協助。

測試版在 Google BigQuery 中存取 HubSpot 資料（測試版）