連接 HubSpot 和 Google BigQuery

瞭解如何連接 HubSpot 和 Google BigQuery，以將 HubSpot 資料同步到您的 Google BigQuery 實例。

請注意：HubSpot不會將HIPAA 資料分享給 Google BigQuery。

連接 HubSpot 和 BigQuery

若要連接 HubSpot 和 Google BigQuery，您必須依序執行下列步驟：

1. 從 HubSpot App Marketplace 安裝 Google BigQuery
2. 在 Google Cloud Platform 中建立自訂 IAM 角色
3. 將自訂角色指定給 Google 服務帳戶
4. 授予 HubSpot 生成的 Google BigQuery 帐户修改 BigQuery 表的权限
5. 在 HubSpot 中完成設定

1.從 HubSpot App Marketplace 安裝 Google BigQuery

建議您在連接兩個應用程式時，分別在不同的標籤中開啟 HubSpot 帳戶和 Google BigQuery 帳戶。

1. 確保您的 HubSpot 帳戶已選擇加入此測試版：在 Google BigQuery 中存取 HubSpot 資料。
2. 導覽到此連結並選擇您的 HubSpot 帳戶。
3. 在右上方，按一下安裝應用程式。
4. 輸入您的Bucket URI和Project ID。
5. 按一下下一步。

6. 查看並記下 Google Service 和 BigQuery 帳戶，因為下一步中您會用到它們。然後導航到您的 Google Cloud 主控台，完成下一步。

2.在 Google Cloud Platform 中建立自訂 IAM 角色

1. 登入 Google Cloud 主控台。
2. 按一下左側導覽功能表，然後選取IAM & Admin >Roles。
3. 在頂端，按一下建立角色。
4. 輸入角色的標題、 可選描述和 ID 。
5. 按一下新增權限。

6. 在表中，選擇下列權限，然後按一下新增：

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

7. 按一下建立。

3.授予 Google 服務帳戶存取 Cloud Storage Buckets 的權限

1. 按一下左側導覽功能表，然後選取Cloud Storage>Buckets。
2. 選取要設定的儲存桶。
3. 按一下權限索引標籤。
4. 在「依主事人檢視」標籤上，按一下授予存取權。

5. 在右側面板的New principals欄位中，輸入步驟 1 中的Google 服務帳戶名稱。

請注意：請確保指定 Google 服務帳戶，而非 BigQuery 帳戶。

6. 在指定角色部分，按一下下拉功能表並選擇 自訂><角色>，其中<角色>是在步驟 2 中建立的自訂 IAM 角色。
7. 按一下儲存。Google 服務帳戶將會新增至儲存物件檢視器 角色。

4.授予 HubSpot 產生的 Google BigQuery 帳戶修改 BigQuery 資料表的權限

1. 按一下左側導覽功能表，然後選擇IAM & Admin>IAM。
2. 按一下授予存取權。
3. 在右側面板的New principals欄位中，輸入步驟 1 中HubSpot 產生的 Google BigQuery 帳戶。
4. 在「指定角色」部分，按一下下拉功能表並選擇 自訂><角色>，其中<角色>是在步驟 2 中建立的自訂 IAM 角色。

5.在 HubSpot 中完成設定

1. 在您的 HubSpot 帳戶中，按一下Continue to Connected Apps。

2. 在對話方塊中，選擇核取方塊，然後按一下允許並安裝。

HubSpot 和 Google BigQuery 之間同步的資料格式

可用於同步的資料

您可以將下列資料從 HubSpot 同步至 Google BigQuery：

• 物件：標準和自訂物件，例如聯絡人、公司、票券或產品。
• 記錄：個別物件記錄。
• 關聯： 所有關聯類型和關聯記錄。
• 事件：標準 HubSpot 事件和自訂行為事件的事件資料。
• 清單： HubSpot 聯絡人和公司清單。
• 所有者： 記錄所有者。
• 管道： 交易和票據管道以及管道階段。
• 屬性： 物件記錄上的屬性及其值，包括屬性歷史。

不同類型的物件資料以兩種方式組織和提供：

• 個別： 每個物件類型儲存在自己的資料表中，且只有相同物件類型的記錄。例如，objects_contacts 只包含聯絡人記錄。
• 合併：所有物件類型的所有記錄都合併到一個資料庫物件中。因此，在查詢時，您需要指定類似 "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 記錄的資料。您可以為物件類型中的每筆記錄取得一列資料 (例如，連絡人物件類型中的所有連絡人記錄)。

物件屬性記錄

本表包含歷史的財產值。對於聯絡人，它包含最近的 45 個值。對於所有其他物件，則包含最近的 20 個值。每個歷史屬性值都有一行。屬性的目前值由該屬性歷史中最近的 UPDAT 時間戳決定。

協會查詢

與物件資料一樣，關聯資料也是以兩種方式組織：

• 個別：每種關聯類型儲存在自己的表中，並且只包含該類型的記錄。例如，associations_contacts_to_deals 只包含聯絡人和交易物件之間的關聯記錄。T
• 合併：所有關聯類型的所有記錄都合併到一個資料表。

關聯_x_to_y

每個關聯類型都有自己的檢視，標示為associations_<association type name> ，例如associations_contacts_to_deals 。

關聯定義

此表包含 HubSpot 物件之間所有可用關聯類型的資訊，每個關聯類型有一列。

屬性定義

本表包含有關 HubSpot 帳戶中物件屬性和事件屬性的資訊。事件屬性包括標準事件，例如電子郵件開啟和點擊，以及自訂行為事件屬性。這些資訊有助於定義object_properties和事件資料中的值。

活動

事件包括標準 HubSpot 事件和自訂行為事件。每個事件都有自己的表格，標示為events_eventname 。

物件及事件類型定義

本表包含 HubSpot 帳戶中所有物件和事件的定義。

同步頻率與資料組織

HubSpot 與 Google BigQuery 之間的資料同步於每日 0600 UTC +0 開始。最近七次的同步資料將提供給 Google Cloud 平台，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