2026 年 10 月 14 日
数据源系列过滤
更新了数据源系列过滤,增加了以下功能:
- 为
users.dataTypes.dataPointslist端点添加了dataSourceFamily参数支持,适用于除sleep、food和food-measurement-unit之外的所有数据类型。 - 向
list、reconcile、rollUp和dailyRollUp端点添加了users/me/dataSourceFamilies/self-sources数据源系列,以便客户端可以查询自己写入的数据点,包括仅被授予.writeonly范围时。
重点文档更新
- 更新了过滤数据指南,其中包含在
list端点上使用dataSourceFamily、使用只写范围查询self-sources以及处理数据类型限制的详细信息和示例。
2026 年 10 月 1 日
新 Beta 渠道
添加了 v4beta 渠道,作为公开预览版,供合作伙伴进行广泛测试和市场验证,然后再升级到稳定的 v4 渠道。仅在 v4beta 中可用的 API 元素将在文档中标记为 v4beta。
如需了解详情,请参阅参考文档。
新增数据类型
添加了对以下数据类型的支持:
- 健康指标和测量:
skin-temperature-sensorsv4beta
新 API 指南
添加了体表温度的新指南,其中详细介绍了如何使用与体表温度相关的数据类型。
2026 年 8 月 17 日
新范围
添加了以下只写范围:
.logged_symptoms.writeonly,用于记录身体症状。.mindfulness.writeonly,用于记录情绪状态和心境。.reproductive_health.writeonly,用于记录月经周期和排卵检测结果。
新增数据类型
添加了对以下数据类型的支持:
- 女性健康:
menstrual-period、moods、ovulation-test、symptoms
重点文档更新
- 添加了女性健康指南,帮助您将女性健康和生殖数据集成到应用中。
2026 年 8 月 14 日
更新后的迁移指南
我们更新了迁移概览,提供了更全面的指南,并移除了一些过时的内容。
新增了“推介 Google Health”页面
新的宣传 Google Health 页面介绍了在应用中展示 Google Health 的推荐方式,以及如何鼓励用户关联。此外,Google Health 品牌指南也已移至此处。
2026 年 6 月 22 日
Google Health 状态信息中心
添加了 Google Health 状态信息中心,以提供有关属于 Google Health 的服务的状态信息。
2026 年 6 月 17 日
Google Health API 对等性工具
更新了 Google Health API 兼容性工具,添加了以下范围:active-energy-burned、electrocardiogram、core-body-temperature、blood-glucose、irregular-rhythm-notification、food、food-measurement-unit、nutrition-log 和 exportExerciseTcx。
2026 年 5 月 26 日
新范围
.ecg.readonly,用于读取心电图数据。.irn.readonly,用于读取 IRN 数据。
范围名称变更
将读/写范围替换为 .writeonly。现在,开发者必须明确指定读写权限。
.activity_and_fitness现为.activity_and_fitness.writeonly.health_metrics_and_measurements现在为.health_metrics_and_measurements.writeonly.nutrition现在为.nutrition.writeonly.profile现在为.profile.writeonly.settings现在为.settings.writeonly.sleep现为.sleep.writeonly
新增数据类型
添加了对以下数据类型的支持:
- 活动与健身:
active-energy-burned - ECG:
electrocardiogram - 健康指标和测量:
core-body-temperature、blood-glucose - IRN:
irregular-rhythm-notification - 营养:
food、food-measurement-unit、nutrition-log
新端点
project.subscribers.subscriptions:用于手动管理订阅的create、delete、list和patch方法。users:getIrnProfile会返回用户当前与 IRN 功能的互动情况users.pairedDevices:get和list与用户账号配对的设备。
Webhook
添加了对以下 Webhook 功能的支持:
- 在注册订阅者时手动订阅支持。
- 支持以下数据类型的通知:
activityLevel、bloodGlucose、dailyRespiratoryRate、heartRateVariability、height、hydrationLog、nutritionLog、respiratoryRateSleepSummary、runVo2Max、sedentaryPeriod、timeInHeartRateZone。 - 在 Google Cloud 控制台中支持自定义指标、提醒和订阅者错误。
- 如果与订阅者的通信中断,系统会自动重试失败的 webhook 通知,最长持续 7 天。
重点文档更新
- 有助于发布应用的内容,包括开发者核对清单和应用验证内容
- Codelab:使用 OAuth2 Playground
- Google Health 品牌推广指南
- 定义的速率限制
2026 年 4 月 14 日
新增数据类型
- 活动与健身:
swim-lengths-data - 健康指标和测量:
height
新端点
project.subscribers:用于手动管理订阅的delete、get、list和patch方法。users.dataTypes.dataPoints:get会根据 ID 返回单个数据点。
Webhook 支持
- 在注册订阅者时自动创建订阅。
- 使用
project.subscribers端点手动管理订阅 - 支持以下数据类型的通知:
activeZoneMinutes、altitude、bodyFat、caloriesInHeartRateZone、dailyHeartRateVariability、dailyHeartRateZones、dailyOxygenSaturation、dailyRestingHeartRate、dailySleepTemperatureDerivations、distance、exercise、floors、heartRate、sleep、steps、totalCalories和weight。
其他功能
- GitHub 上的 REST 库:Google Health API REST 库适用于 GitHub 项目 Google API 中包含的所有受支持的客户端库。
- 支持 API Explorer:可以使用参考文档中内置的 API Explorer 调用端点。
- 支持 OAuth Playground:Google Health API v4 已在 OAuth 2.0 Playground 中列出,该工具可让您调用支持 Google OAuth 库的端点。
2026 年 3 月 24 日
Google Health API 发布公告
Google Health API 是 Fitbit Web API 的新一代产品,专为我们宝贵的开发者社区而设计。此初始版本专注于在最常用的数据类型上实现与 Fitbit Web API 的功能对等,并添加了开发者社区要求的功能。下面我们来看看目前可用的功能。
核心功能亮点
- 简化设置:直接通过熟悉的 Google Cloud 控制台注册项目并管理 OAuth 客户端 ID。
- 广泛的平台支持:基于 Google OAuth2 库构建,可跨所有主要编程语言和平台实现无缝集成。
- 简化了数据访问:利用新的范围定义,将多种数据类型整合到一个易于管理的范围内。
- 跨数据类型的一致端点:体验更简单的编码之旅,其中包含新的统一端点和过滤支持,旨在简化所有数据类型的功能。
- 全面的数据覆盖范围:支持多种数据类型的读取和写入。
- 实时通知:通过增强的 Webhook 支持即时接收更新,具有自动订阅创建和更丰富的通知消息内容。
- 默认支持日内数据:默认情况下,使用列表端点检索精细的日内数据,省去额外步骤。
- 完整的文档套件:借助我们全新的综合文档,快速上手并运行,其中包括:
- 入门指南、API 指南、迁移指南和问题排查指南
- REST 完整参考指南
- 全新 Google Health API Parity 工具、示例代码和引导式 Codelab
支持的数据类型
此次发布提供了对基本数据类型的访问权限,确保您拥有构建创新健康解决方案所需的核心信息。
支持读取的数据类型:
- 活动与健身:活跃分钟数、活跃区间分钟数、活动水平、海拔高度、心率区间内的卡路里消耗量、每日最大摄氧量、距离、锻炼、楼层、跑步最大摄氧量、久坐时间、步数、心率区间内的时间、总卡路里消耗量、最大摄氧量
- 健康指标和测量数据:体脂、每日心率变异性、每日心率区间、每日血氧饱和度、每日呼吸频率、每日静息心率、每日睡眠体温偏差、心率、心率变异性、血氧饱和度、呼吸频率睡眠状况摘要、体重
- Identity:返回 Fitbit 用户 ID 和 Google 用户 ID
- 位置:基于以 TCX 格式公开的记录锻炼的 GPS 数据
- 营养:饮水量记录
- 个人资料:用户的基本个人资料信息
- 设置:用户配置的设备和移动应用设置
- 睡眠:经典睡眠记录和睡眠阶段记录
支持写入的数据类型:
您可以写入和修改以下数据类型的数据:
- 活动和健身:锻炼
- 健康指标和测量数据:体脂、体重
- 配置文件
- 设置
- Sleep
互动关键端点
您可以使用以下端点来管理订阅、用户以及健康与健身数据:
users:用于身份和个人资料管理的getIdentity、getProfile、getSettings、updateProfile和updateSettings方法。users.dataTypes.dataPoints:batchDelete、dailyRollUp、list、patch、reconcile和rollUp方法,用于全面的数据类型管理。