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用于读取 ECG 数据。.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
新版 Endpoints
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 天。
突出显示的文档更新
- 可帮助您发布应用的内容，包括开发者核对清单和应用验证内容
- 有关使用 OAuth2 Playground 的 Codelab
- Google Health 品牌推广指南
- 已定义的速率限制
2026 年 4 月 14 日
新数据类型
- 活动与健身：
swim-lengths-data - 健康指标和测量：
height
新版 Endpoints
project.subscribers：用于手动管理订阅的delete、get、list和patch方法。users.dataTypes.dataPoints：get会根据 ID 返回单个数据点。
网络钩子支持
- 在订阅者注册时自动创建订阅。
- 使用
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 库适用于 Google API GitHub 项目中包含的所有受支持的客户端库。
- 支持 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 支持，立即接收更新，包括自动创建订阅和更丰富的通知消息内容。
- 默认支持日内数据：使用 list 端点默认检索精细的日内数据，无需执行额外的步骤。
- 完整文档套件：借助我们全新的全面文档快速上手，其中包括：
- 使用入门、API、迁移和问题排查指南
- REST 完整参考指南
- 新的 Google Health API 对等性工具、示例代码和引导式 Codelab
支持的数据类型
此次发布可让您访问基本数据类型，确保您拥有构建创新健康解决方案所需的核心信息。
支持读取的数据类型：
- 活动和健身：活跃分钟数、活跃区间分钟数、活动强度、海拔、心率区间内的卡路里、每日最大摄氧量、距离、锻炼、楼层、跑步最大摄氧量、久坐时间、步数、心率区间内的时长、总卡路里、最大摄氧量
- 健康指标和测量数据：体脂、每日心率变异性、每日心率区间、每日血氧饱和度、每日呼吸频率、每日静息心率、每日睡眠体温推导值、心率、心率变异性、血氧饱和度、呼吸频率睡眠总结、体重
- 身份：返回 Fitbit 用户 ID 和 Google 用户 ID
- 位置信息：以 TCX 格式公开的基于记录的锻炼的 GPS 数据
- 营养：饮水量记录
- 个人资料：用户的基本个人资料信息
- 设置：用户配置的设备和移动应用设置
- 睡眠：经典睡眠记录和睡眠阶段记录
支持写入的数据类型：
您可以写入和修改以下数据类型的数据：
- 活动和健身：锻炼
- 健康指标和测量数据：体脂、体重
- 配置文件
- 设置
- Sleep
关键互动端点
以下端点可用于管理订阅、用户以及健康和健身数据：
users：用于身份和个人资料管理的getIdentity、getProfile、getSettings、updateProfile和updateSettings方法。users.dataTypes.dataPoints：batchDelete、dailyRollUp、list、patch、reconcile和rollUp方法，用于全面管理数据类型。