版本说明

2026 年 10 月 14 日

数据源系列过滤

更新了数据源系列过滤,增加了以下功能:

  • 为 users.dataTypes.dataPoints list 端点添加了 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-sensors v4beta

新 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

新端点

Webhook

添加了对以下 Webhook 功能的支持:

  • 在注册订阅者时手动订阅支持。
  • 支持以下数据类型的通知:activityLevel、bloodGlucose、dailyRespiratoryRate、heartRateVariability、height、hydrationLog、nutritionLog、respiratoryRateSleepSummary、runVo2Max、sedentaryPeriod、timeInHeartRateZone。
  • 在 Google Cloud 控制台中支持自定义指标、提醒和订阅者错误。
  • 如果与订阅者的通信中断,系统会自动重试失败的 webhook 通知,最长持续 7 天。

重点文档更新

2026 年 4 月 14 日

新增数据类型

  • 活动与健身:swim-lengths-data
  • 健康指标和测量:height

新端点

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 方法,用于全面的数据类型管理。