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 范围都被归类为“受限”,因此需要进行隐私权和安全性审核才能获得访问权限。

发现了心仪好物?立即开始使用

Fitbit Web API 呢?

2026 年 9 月,旧版 Fitbit Web API 将被停用,届时将无法再与 Fitbit 用户同步数据。所有当前使用 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 年第 2 季度

数据类型(读取)

  • 活动与健身:目标、历史统计数据、175 多种活动类型(5 月底)
  • 心电图 (ECG)
  • 健康指标和测量数据:血糖、体温、核心体温
  • 心律不齐通知 (IRN)
  • 营养:饮食记录

数据类型(写入)

  • 活动和健身:活跃分钟数、活跃区间分钟数、活动水平、海拔、距离、锻炼、楼层数、目标、跑步最大摄氧量、久坐时间、步数、总卡路里、最大摄氧量
  • 心电图 (ECG)
  • 健康指标和测量数据:血糖、体脂、体温、心率区间内的卡路里、核心体温、每日心率变异性、每日心率区间、每日血氧饱和度、每日呼吸频率、每日静息心率、每日睡眠体温派生数据、心率、心率变异性 (HRV)、血氧饱和度、呼吸频率睡眠总结、心率区间内的时长
  • 心律不齐通知 (IRN)
  • 位置信息:记录的锻炼期间的 GPS 坐标
  • 营养:饮水量记录、饮食记录
  • Sleep

特点

  • batchGet 个端点
  • HTTP 和 gRPC 库
  • rollUp 分页
  • 插入/更新增强功能
  • Webhook 增强功能,包括新的数据类型、用户删除通知、统计信息 API、针对不活跃订阅者的自动停用功能和订阅者停用通知

2026 年第 3 季度

数据类型(读取和写入)

  • 基础体温
  • 血压
  • 活动消耗的卡路里数
  • 基础代谢率
  • 女性健康
  • 正念

特点

  • 网络钩子增强功能
  • 新增了 list 端点过滤条件支持