连接 HubSpot 和 Google BigQuery

了解如何连接 HubSpot 和 Google BigQuery，以便将 HubSpot 数据同步到 Google BigQuery 实例。

请注意：HubSpot不会向 Google BigQuery 共享 HIPAA 数据。

连接 HubSpot 和 BigQuery

要连接 HubSpot 和 Google BigQuery，必须依次完成以下步骤：

1. 从 HubSpot 应用程序市场安装 Google BigQuery
2. 在谷歌云平台中创建自定义 IAM 角色
3. 将自定义角色分配给谷歌服务账户
4. 授予HubSpot生成的Google BigQuery账户修改BigQuery表的权限
5. 在HubSpot中完成设置

1.从 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 云平台中创建自定义 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 服务帐户访问云存储桶的权限

1. 单击左侧导航菜单并选择Cloud Storage（云存储）>Buckets。
2. 选择要配置的存储桶。
3. 单击权限选项卡。
4. 在 "按负责人查看"选项卡上，单击 "授予访问权限"。

5. 在右侧面板的 "新委托人"字段中，输入步骤 1 中的Google 服务账户名称。

请注意：确保分配的是 Google 服务帐户，而不是 BigQuery 帐户。

6. 在 "分配角色"部分，单击下拉菜单并选择 自定义><角色>，其中<角色>是在步骤 2 中创建的自定义 IAM 角色。
7. 单击保存。Google 服务账户将添加到存储对象查看器 角色。

4.授予 HubSpot 生成的 Google BigQuery 帐户修改 BigQuery 表的权限

1. 单击左侧导航菜单，选择IAM & Admin>IAM。
2. 单击 "授予访问权限"。
3. 在右侧面板的新委托人字段中，输入步骤 1 中HubSpot 生成的 Google BigQuery 帐户。
4. 在 "分配角色"部分，单击下拉菜单并选择 自定义><role>其中<role>是在步骤 2 中创建的自定义 IAM 角色。

5.在 HubSpot 中完成设置

1. 在 HubSpot 账户中，单击 "继续连接应用程序"。

2. 在对话框中，选择复选框，然后单击允许并安装。

在 HubSpot 和 Google BigQuery 之间同步的数据格式

可用的同步数据

您可以将以下数据从 HubSpot 同步到 Google BigQuery：

• 对象：标准和自定义对象，如联系人、公司、票据或产品。
• 记录：单个对象记录。
• 关联： 所有关联类型和关联记录。
• 事件：标准 HubSpot 事件和自定义行为事件的事件数据。
• 列表： HubSpot 联系人和公司列表。
• 所有者： 记录所有者。
• 管道： 交易和票据管道以及管道阶段。
• 属性： 对象记录上的属性及其值，包括属性历史记录。

不同类型的对象数据以两种方式组织和提供：

• 单个： 每个对象类型存储在自己的表中，并且只有相同对象类型的记录。例如，objects_contacts 只包含联系人记录。
• 合并：所有对象类型的所有记录都合并到一个数据库对象中。因此，在查询时，需要指定一个过滤器，如 "WHERE objectTypeId='0-1'

自定义对象将在创建时分配一个 ID，标识为2-unique_ID。例如，2-12345。

对象_x 表

每种可用的对象类型（包括自定义对象）都有自己特定的表格。这些表格按照OBJECTS_<object type name> 的格式命名，其中<object type name> 是objecttype 的复数形式标签。（注意，如果对象类型没有复数形式，则<object type name> 将是对象类型名称的单数形式标签，并与 "S "连接）。

下面是可用 HubSpot 对象类型的完整列表、它们所代表数据的简短描述以及相应的表格。

带对象属性的对象

该表包含 HubSpot 记录中的数据。您可以为对象类型中的每条记录获取一行数据（例如，联系人对象类型中的所有联系人记录）。

对象属性历史

本表包含历史属性值。对于联系人，它包含最近的 45 个值。对于所有其他对象，它包含最近的 20 个值。该表中的每个历史属性值都有一行。属性的当前值由属性历史记录中最新的 UPDATEDAT 时间戳决定。

关联查询

与对象数据一样，关联数据也有两种组织方式：

• 单个：每种关联类型存储在自己的表中，只包含该类型的记录。例如，associations_contacts_to_deals 只包含联系人和交易对象之间的关联记录。T
• 合并：所有关联类型的所有记录都合并到一个表中。

联想_x_to_y

每种关联类型都有自己的视图，标记为associations_<association type name> ，如associations_contacts_to_deals 。

关联定义

此表包含 HubSpot 对象之间所有可用关联类型的信息，每个关联类型有一行。

属性定义

本表包含有关 HubSpot 账户中对象属性和事件属性的信息。事件属性包括标准事件（如电子邮件打开和点击）和自定义行为事件属性。这些信息有助于定义对象属性和事件数据中的值。

活动

事件包括标准 HubSpot 事件和自定义行为事件。每个事件都有自己的表格，标记为events_eventname 。

对象和事件类型定义

本表包含 HubSpot 账户中所有对象和事件的定义。

同步频率和数据组织

HubSpot 和 Google BigQuery 之间的数据同步从每日 0600 UTC +0 开始。最近七次同步的数据将在 Google 云平台上提供，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