Google Health API 简介

Fitbit Web API 经过改进和现代化改造,为开发者集成提供了更标准化、更一致且更具可扩展性的基础,现已更名为 Google Health API。Google Health API 是旧版 Fitbit Web API 的战略演进,在 Google 的现代基础架构上从头开始重建。

借助此平台,开发者可以充分利用 Google Cloud 开发者工具的强大功能,并让用户能够通过 Google OAuth 2.0 以熟悉、简化的方式管理其权限。

Google Health API 有哪些功能?

  • 统一的可信来源:我们全新的“协调数据流”可处理复杂的任务,即协调来自多个来源的重叠数据点。这可确保应用显示与用户在 Fitbit 应用中看到的相同且一致的数据。除了包含来自 Fitbit 和 Pixel 设备的数据以及手动条目的第一方数据流之外,我们还将提供此数据流。
  • 技术现代化和性能:我们已将 100 多个旧版端点整合为一组精简的数据类型包,并消除了数据格式、时区、测量单位和错误处理方面的不一致。此外,我们现在还支持 HTTP/REST 协议,以实现高性能数据检索。此外,现在可以通过专用列表端点为所有相关数据类型提供日内数据和 webhook。
  • 增强型 webhook 和可伸缩性:受益于扩展的 webhook 支持,包括自动订阅和针对所有相关数据类型的详细管理,旨在随着下一代 AI 驱动的健康类应用进行扩缩。
  • 简化的身份和安全机制:将旧版 Fitbit 授权 (FOT) 替换为 Google OAuth 2.0。这样,开发者就可以利用标准的 Google 身份验证库,从而简化代码库,同时为用户提供一种熟悉的集中式权限管理方式。所有 Google Health API 范围均归类为“受限”,需要通过隐私和安全审核才能访问。

觉得不错?立即开始使用!

API 版本和公开 Beta 版渠道

Google Health API 根据 Google 的 API 改进提案 (AIP)(具体而言,AIP-185:API 版本控制和 AIP-181:稳定性级别)使用基于渠道的版本控制。该 API 可通过两个公开渠道获取:稳定的 v4 渠道和公开 Beta 版 v4beta 渠道。Google 通过标准支持渠道为这两个渠道提供支持。

比较稳定渠道和 Beta 渠道

根据 AIP-185,v4beta 渠道充当稳定 v4 渠道的超集。它包含所有稳定的 v4 功能,以及正在接受合作伙伴测试的抢先体验版数据类型、字段和方法。

在文档中,仅在 Beta 渠道中提供的 API 元素会显示 v4beta 标签。

功能 稳定渠道 (v4) 公开 Beta 版渠道 (v4beta)
REST 基本 URI https://health.googleapis.com/v4 https://health.googleapis.com/v4beta
gRPC 软件包 google.devicesandservices.health.v4 google.devicesandservices.health.v4beta
参考文档 v4 REST 和 v4 RPC v4beta REST 和 v4beta RPC
稳定性级别 可用于生产用途,并受 AIP-180 向后兼容性规则约束。 不稳定的预览版,随时可能发生不兼容的更改或被移除,恕不另行通知。
预期用途 面向用户的实时生产应用。 早期测试、原型设计、架构验证和开发者反馈。
支持 通过标准支持渠道提供支持。 通过标准支持渠道提供支持,以便报告错误、排查问题和提供设计反馈。

如何处理 v4beta 渠道

探索带有 v4beta 标记的功能时,请遵循以下准则:

  • 主要在开发、预演和非生产测试环境中使用 v4beta。不建议发布依赖于 v4beta 端点或仅限 Beta 版的数据类型的正式版功能。
  • v4beta 中的架构、字段名称、端点行为和数据表示可能会发生变化,恕不另行通知。如果 Beta 版功能和数据类型未达到验证目标,也可能会被完全移除。
  • 将实验性 v4beta 客户端代码隔离在功能标志或单独的模块后面,这样 Beta 渠道中的破坏性更改就不会干扰您的核心 v4 集成。
  • 通过我们的标准支持渠道获取支持、报告问题并分享有关 v4beta 的实现反馈,帮助我们完善最终的 API 设计。

从 v4beta 升级到稳定版 v4

新的数据类型和功能会进入 v4beta,以支持合作伙伴测试和市场验证,然后再升级到稳定的 v4 渠道。

Google 会根据以下标准评估 Beta 版功能,然后再将其升级为 v4:

  • 合作伙伴测试可确认数据模型、字段语义和查询句式是否符合实际应用要求。
  • 开发者反馈和设计审核已完成,架构已准备好根据 AIP-180 向后兼容性保证进行锁定。
  • 端到端数据流水线、设备同步和服务可靠性均符合生产质量标准。
  • 根据 AIP-185 弃用规则,在 Beta 版测试期间弃用的任何字段或行为都会被移除,而不会升级到 v4。

虽然 AIP-181 提供了大约 90 天的 Beta 版评估一般经验法则,但将功能从 v4beta 升级到 v4 的实际时间取决于功能复杂性、硬件可用性和验证反馈。部分功能可能会更快毕业,而其他功能可能会在 v4beta 中保留更长时间或被停用。

当数据类型或功能升级到稳定版 v4 渠道时,Google 会在版本说明中宣布升级。届时,请先将请求从 https://health.googleapis.com/v4beta 更新为 https://health.googleapis.com/v4,然后再向正式版用户发布集成。

Fitbit Web API 呢?

旧版 Fitbit Web API 已按照以下时间表停用:

  • 2026 年 9 月 30 日(停止支持):Fitbit Web API 停止支持,Google 停止修复 bug 或提供 API 支持。
  • 2026 年 11 月 2 日(API 关闭):Fitbit Web API 和 Fitbit OAuth 端点已关闭,不再运行,也不再与 Google Health 用户同步数据。对这些端点的请求会失败,并返回 HTTP 410 Gone 状态代码。

使用旧版 Fitbit Web API 和 Fitbit 授权的开发者应将其应用和用户迁移到 Google Health API 和 Google OAuth 2.0。

如需开始迁移,请参阅迁移指南。

支持哪些设备?

所有 Fitbit 设备和 Google Pixel Watch(包括当前和以前的型号)都会收集通过 Google Health API 返回的数据。可用数据的类型取决于设备支持的功能。

您可以在 Google 商店中找到当前设备列表。

我如何提供反馈?

您的反馈对我们至关重要。我们鼓励您通过我们的支持渠道分享您的想法,这些渠道列在支持页面上。

虽然我们已竭尽全力确保这些 API 能够为您提供良好的支持,但 Google Health API 仍在不断发展。请注意,根据您的反馈,我们可能会在现在到 5 月底之间进行更改,这需要您进行相应的更新。

路线图

以下是 2026 年即将推出的功能。

2026 年第 4 季度

数据类型(读写)

  • 精细体表温度
  • 基础代谢率 (BMR)
  • 我们将添加数据类型,以与“健康数据共享”保持一致。预计在 2026 年第 4 季度和 2027 年第 1 季度,我们将添加更多健康数据共享数据类型。

特点

  • 公开 Beta 版渠道,可抢先体验新数据类型
  • 用于监控 webhook 遥测数据的统计信息端点