測試版連結 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應用程式時，建議您在不同的分頁中開啟HubSpot 帳戶 和Google BigQuery帳戶。 

1. 請確保您的HubSpot 帳戶 已加入測試版：在Google BigQuery中存取HubSpot資料。 
2. 前往 此連結 ，然後選擇您的HubSpot 帳戶。 
3. 按一下「 安裝」。
4. 輸入您的Bucket URI和專案ID。 
5. 按一下 下一步。 
6. 檢查並記錄Google服務和BigQuery帳戶，因為您在下一步中將需要這些帳戶。然後前往Google雲端主控臺，完成下一步。 

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

1. 登入您的Google雲端主控臺。 
2. 按一下左側導覽選單，然後選取IAM & 管理員> 角色。 
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服務 帳戶 存取雲端儲存區的權限

1. 按一下左側導覽選單，然後選取雲端儲存 > 區。 
2. 選取要設定的儲存區 。 
3. 按一下「 權限 」索引標籤。
4. 在「 依主體檢視 」索引標籤上，按一下「 授予存取權限」。 

5. 在右側面板的「新主體」欄位 中，輸入步驟1中的Google服務 帳戶 名稱。

請注意： 請務必指定Google服務 帳戶，而不是BigQuery 帳戶。

6. 在「指派角色 」部分，按一下 下拉式選單 ，然後選取「自 訂」， > <role> 其中 <role> 是在步驟2中建立的自訂IAM角色。 
7. 按一下儲存。Google服務 帳戶 將新增至儲存 物件 檢視器角色。 

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

1. 按一下左側導覽選單，然後選擇 IAM & 管理員 > IAM。 
2. 按一下「授予存取權限」。
3. 在右側面板的「新主體」欄位 中，輸入HubSpot從步驟1產生的 Google BigQuery 帳戶 。
4. 在「指派角色 」部分，按一下 下拉式選單 ，然後選取「自 訂」， > <role> 其中 <role> 是在步驟2中建立的自訂IAM角色。 

5.在HubSpot中完成設定

1. 回到您的HubSpot 帳戶，按一下「 繼續」至「已連結的應用程式」。 
2. 在對話方塊中，選取 核取方塊，然後按一下允許並安裝。 

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

可用於同步的數據

您可以將以下數據從HubSpot同步到Google BigQuery ： 

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

不同類型的物件數據以兩種方式組織並可用：

• 個人：每個 物件類型 都儲存在自己的表格中，並且只有相同 物件類型 記錄。例如，只 objects_contacts 包含 連絡人 記錄。
• 合併：所有 物件 類型的ll記錄合併成一個資料庫 物件。因此，在查詢時，您需要指定一個篩選器，例如“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 物件 類型的完整 清單、它們所代表的資料的簡短說明及其對應的表格。

object_with_object_properties

此表包含您的HubSpot記錄中的資料。您可以為物件類型中的每個 記錄 獲得一行（例如，連絡人 絡人記錄）。 

對象_特性_歷史

此表包含歷史 屬性 值。對於聯系人，它包含最新的45值。對於所有其他對象，它包含最近的20個值。表格中的每個歷史 屬性 值都有一行。物業的當前值由 屬性 歷史記錄中最新的UPDATEDAT時間戳記決定。

關聯 查詢

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

• 個人： 每個 關聯 類型都存儲在自己的表中，並且只包含該類型的記錄。例如，僅 associations_contacts_to_deals 包含客服案件與 交易 物件之間的 關聯 連絡人 記錄。T
• 合併： 所有 關聯 類型的所有記錄都合併到一個表格中。

associations_x_to_y 

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

association_definition

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

特性定義

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

事件

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

object_and_event_type_definition

此表包含您HubSpot 帳戶 中可用的所有物件和事件的定義。

同步頻率和資料組織

HubSpot和Google BigQuery之間的資料同步作業每天大約在UTC時間上午6:00開始。數據同步到Google BigQuery所需的時間取決於 帳戶 的佇列位置和數據量。不保證完成時間。

將為每天建立一個資料夾，資料將與每個表格的多個子資料夾同步。最後七個同步將在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