跳到内容

连接 HubSpot 和 Google BigQuery(BETA)

上次更新时间: 二月 13, 2025

除非另有说明,否则适用于以下任何订阅

Operations Hub   Enterprise

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

连接 HubSpot 和 BigQuery

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

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

1.从 HubSpot 应用程序市场安装 Google BigQuery

在连接这两个应用程序时,建议在不同的标签页中分别打开 HubSpot 帐户和 Google BigQuery 帐户。

  • 确保您的 HubSpot 帐户已选择加入此测试版:在 Google BigQuery 中访问 HubSpot 数据。
  • 导航至此链接并选择您的 HubSpot 账户。
  • 在右上角,单击安装应用程序。
  • 输入您的水桶 URI 和项目 ID。
  • 单击下一步。

  • 查看并记下 Google 服务和 BigQuery 帐户,因为下一步会用到它们。然后,导航到 Google 云控制台完成下一步。

2.在谷歌云平台中创建自定义 IAM 角色

  • 登录 Google Cloud 控制台。
  • 单击左侧导航菜单,选择IAM 和管理员 > 角色。
  • 在顶部单击 "创建角色"。
  • 输入角色的标题、 可选描述和 ID 。
  • 单击添加权限。

  • 在表中选择以下权限,然后单击添加:

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

  • 单击创建。

3.将自定义角色分配给云存储服务帐户

  • 单击左侧导航菜单并选择云存储>桶。
  • 选择要配置的水桶。
  • 单击 "权限"选项卡。
  • 在 "按负责人查看"选项卡上,单击 "授予访问权限"。

  • 在右侧面板的 "新委托人"字段中,输入步骤 1 中的Google 服务账户名称。
  • 在 "分配角色"部分,单击下拉菜单并选择 自定义><角色>,其中<角色>是在步骤 2 中创建的自定义 IAM 角色。
  • 单击保存。Google 服务账户将添加到存储对象查看器 角色中。

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

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

5.在 HubSpot 中完成设置

  • 在 HubSpot 账户中,单击 "继续连接应用程序"。

  • 在对话框中,选择复选框,然后单击允许并安装。

在 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 对象类型

对象类型标识

说明

联系

0-1

与您的企业互动的个人相关信息

公司

0-2

有关个别企业或组织的信息

DEAL

0-3

有关联系人或公司收入机会的详细信息。

参与

0-4

存储来自 CRM 操作的数据,包括备注、任务、电子邮件、会议和通话。

门票

0-5

代表客户寻求帮助或支持。

引用

0-14

用于与潜在买家分享定价信息。

提交表单

0-15

HubSpot 表单个人提交的详细信息。

行_项目

0-8

代表交易中销售产品的子集。产品附加到交易后,就成为一个细列项目。

对话

0-11

多渠道接收信息的详细信息。

登陆页面

0-25

登陆页面的详细信息

任务

0-27

存储待办事项信息

表格

0-28

用于收集访客和联系人的线索信息

营销电子邮件

0-29

营销中心电子邮件的详细信息

AD_ACCOUNT

0-30

存储您在 Linkedin、Facebook 和 Google 上的广告账户信息

AD_CAMPAIGN

0-31

有关广告系列的详细信息。一个广告系列可包含一个或多个广告

AD_GROUP

0-32

在广告系列中对广告进行逻辑分组

AD

0-33

单个广告的详细信息

活动

0-35

相关营销资产和内容的信息,方便您衡量集体营销工作的效果。

网站页面

0-38

有关网站单个页面的数据

博客文章

0-39

博客文章数据

目标 清单

0-45

基于属性或活动的对象记录分组信息

呼叫

0-48

其他客户关系管理记录(如联系人)拨打的电话

发票

0-53

管理发票并与外部会计系统同步

媒体桥

0-57

有关导入 HubSpot 的媒体资产的信息

序列

0-58

序列是一系列有针对性、定时的电子邮件模板,用于在一段时间内培养联系人

DEAL_SPLIT

0-72

交易拆分用于在多个用户之间共享交易积分

销售文档

0-83

销售文件可为整个团队建立一个内容库,以便上传文件并与联系人共享。

反馈提交

0-19

存储提交给反馈调查的信息。

订阅

0-69

订阅包含定期付款的详细信息

商务付款

0-101

包含从客户处收集的资金数据

带对象属性的对象

该表包含 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 之间的数据每日同步,同步时间为 0900 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

这篇文章有帮助吗?
此表单仅供记载反馈。了解如何获取 HubSpot 帮助