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 遥测数据的统计信息端点