上次更新时间： 2026年9月4日
将 Google BigQuery 中的数据与 HubSpot CRM 对象（例如联系人、公司、商机、关联关系）以及您账户中的其他数据进行同步。
以下各部分将指导您如何授权 Google BigQuery 应用，然后配置 Google Cloud 账户与 HubSpot 之间的同步设置。
需要权限 您必须是 HubSpot 账户中的超级管理员才能安装此集成。
连接并配置 Google BigQuery 集成
要将您的 Google BigQuery 账户连接到 HubSpot：
- 在 HubSpot 帐户中，单击顶部导航栏中的“商城”图标
，然后选择 HubSpot 商城。 - 点击搜索栏，输入“Google BigQuery”。
- 在 列表页面中 点击“Google BigQuery ”。
- 点击“安装”。
- 点击“继续设置”。
您将被重定向至“数据集成”工具，该工具的侧边栏将根据您希望的同步方向，引导您完成 HubSpot 与 BigQuery 账户之间的数据同步：
- Google BigQuery → HubSpot：配置从 BigQuery 到 HubSpot 的同步。
- HubSpot → Google BigQuery：配置从 HubSpot 到 BigQuery 的同步。
将 Google BigQuery 数据同步到您的 HubSpot 账户
某些功能需要 HubSpot 点数 从 Data Studio 中的单一数据仓库源直接将数据同步到 HubSpot CRM 不会消耗HubSpot 积分。 如果您在同步前先在 Data Studio 中对数据进行预处理（例如，创建计算字段或与其他数据源进行关联），则这些操作会消耗 HubSpot 积分。
要将 Google BigQuery 数据发送至 HubSpot，请在您的 BigQuery 账户中添加并配置一个具有所需角色的新用户：
- 在右侧窗格中，选择Google BigQuery → HubSpot。
- 复制 HubSpot 生成的 Google 服务账户邮箱地址。
- 在您的 Google Cloud 账户中，转到项目 IAM 设置，使用从 HubSpot 复制的服务账户邮箱创建一个新用户，然后为该新用户添加BigQuery 数据查看者和 BigQuery 作业用户角色。
- 从您的 Google Cloud 账户中复制项目 ID。
- 返回 HubSpot，粘贴该项目 ID，然后点击“测试连接”。
- 连接验证通过后，点击“下一步 ”以 完成设置。
将 HubSpot 数据同步到您的 Google BigQuery 账户
要将 HubSpot 数据发送至 Google BigQuery，您需要在 Google Cloud 账户中配置一个具有所需权限的用户，并指定相关的 GCP 项目和 GCS 存储桶 URI。
请注意：您需要拥有 Google Cloud 管理员权限，才能访问将托管 BigQuery 数据集的 GCP 项目，并需要一个 Google Cloud Storage (GCS) 存储桶，用于 HubSpot 暂存 Parquet 文件。
- 在右侧窗格中，选择HubSpot → Google BigQuery。
- 复制 HubSpot 生成的 Google 服务账户邮箱地址。
- 在您的 Google Cloud 账户中，转到项目 IAM 设置，使用从 HubSpot 复制的服务账户邮箱创建一个新用户，然后为该新用户添加BigQuery 数据查看者、BigQuery 作业用户和 Storage 对象所有者角色。
- 从您的 Google Cloud 账户中复制项目 ID。
- 返回 HubSpot，粘贴该项目 ID。
- 添加您的 Google Cloud Storage (GCS) 存储桶 URI：
- GCS 存储桶的 URI 应遵循以下结构：
gs://{bucket}/hubspot-dataout/{portalId}/{runId}/{tableName}/ - BigQuery 外部表将在 GCP 项目中的专用数据集内创建，并遵循以下格式：
hubspot_data_set_{hubId} - 数据将写入 GCS 存储桶，相关表将引用 GCS 中的 Parquet 文件。
- 有关创建 GCS 存储桶的更多信息，请参阅 Google 的文档。
- GCS 存储桶的 URI 应遵循以下结构：
- 点击“测试连接”。
- 验证连接成功后，点击“下一步”。
- 选中您想要同步的数据源旁边的复选框（例如，“联系人”、“关联”、“事件”等）。
- 配置同步频率和计划。
- 点击“开始同步”。
监控同步情况
配置好账户间的同步后，您可以在“同步详情”页面查看同步状态和历史记录：
- 在你的 HubSpot 帐户中，单击更多，然后导航到数据管理 > 数据集成。如果你的帐户中未显示更多，请直接导航到数据管理 > 数据集成。
- 在“监控导入和同步”下，点击“应用同步”选项卡。
- 点击搜索栏，搜索“Google BigQuery”。
- 点击Google BigQuery。请注意，如果您已配置双向同步，可能会出现多个条目。
- 在同步详情页面，您可以管理和查看同步设置及历史记录：
- 若要归档或编辑同步详情，请在右上角点击“操作”，然后选择相应的选项。
- 若要立即触发同步，请在右上角点击“立即 同步”。
- 页面顶部汇总了已同步的记录、关联关系和错误。
- 表格中将显示最近的同步活动。点击“同步历史记录”选项卡可查看具体的同步尝试和完成情况。您可以按特定日期范围或同步状态进行筛选。
同步状态与错误处理
下表概述了可能的同步状态：
| 状态 | 描述 |
| 正在同步 | 当前正在尝试同步。 |
| 已同步 | 上次同步已成功完成。 |
| 失败 | 上次同步时出现错误。 |
| 已归档 | 该同步配置已被手动删除，但仍可查阅以供参考。 |
如果同步失败：
- 同步详情页面将显示“失败”状态，并附有哪些表同步成功或失败的相关信息。
- 失败时不会部分写入数据：BigQuery 表仅在同步成功完成后才会更新。
- 下次计划的同步将自动重新尝试进行完整同步。
- 您可以随时从同步详情页面手动触发重新同步。
网络白名单
将 HubSpot 数据同步到 BigQuery 等第三方服务提供商时，数据会通过 HubSpot 的代理 IP 进行路由。这些 IP 范围也被其他 HubSpot 集成（例如数据同步和 Webhook）所使用。
如果您的组织限制了对 GCP 资源的入站访问，您应根据您的 HubSpot hublet 将以下 CIDR 范围加入白名单：
| Hublet | CIDR |
| NA1 | 54.174.62.128/26 |
| NA2 | 216.157.40.32/27 |
| NA3 | 216.157.41.32/27 |
| EU1 | 143.244.87.0/25 |
| AP1 | 216.157.42.32/27 |
了解如何查询您的 HubSpot 账户数据托管的位置。
测试版限制
在本次测试期间，请注意以下限制：
-
同步频率：可用的同步频率取决于同步方向。您可以随时在 HubSpot 的同步详情页面手动触发重新同步。
- HubSpot 到 Google BigQuery：一次、每 6 小时、每 12 小时、每天、每周或每月。
- 从 Google BigQuery 到 HubSpot：每 15 分钟、每 30 分钟、每小时、每 2 小时、每 3 小时、每 6 小时、每 12 小时、每天、每周或每月。
- 每种数据类型仅限一次导出：每个 对象类型、事件类型或关联对，在每个 HubSpot 账户中仅能在一个同步配置中进行导出。
- 例如，如果联系人数据已导出到一个 BigQuery 目标，则在原始目标被归档之前，无法将其添加到第二个配置中。
- 此机制可避免数据管道重复，并确保数据仓库中每种数据类型仅有一个可信数据源。
- 对敏感数据的支持有限：您可以将敏感数据存储在 HubSpot 账户中并进行同步，但无法将敏感数据同步到 BigQuery 账户。
- 不支持 object_x_views：目前不支持将object_x_views 对象与 BigQuery 进行同步。请使用
object_with_object_properties，或将objects与object_properties进行连接，以获得等效的每条记录视图。
后续步骤
连接 BigQuery 集成并配置好同步设置后，请了解BigQuery 中同步表的模式。
