版本说明

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

新端点

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 对等工具、示例代码和引导式 Codelab

支持的数据类型

此次发布提供了对基本数据类型的访问权限，确保您拥有构建创新健康解决方案所需的核心信息。

支持读取的数据类型：

  • 活动和健身 ：活跃分钟数、活跃区间分钟数、活动级别、海拔、心率区域中的卡路里数、每日最大摄氧量、距离、锻炼、楼层、跑步最大摄氧量、静坐时间、步数、心率区域中的时间、总卡路里数、最大摄氧量
  • 健康指标和测量数据 ：体脂、每日心率变异性、每日心率区域、每日血氧饱和度、每日呼吸频率、每日静息心率、每日睡眠温度推导值、心率、心率变异性、血氧饱和度、呼吸频率睡眠摘要、体重
  • 身份：返回 Fitbit 用户 ID 和 Google 用户 ID
  • 位置：基于以 TCX 格式公开的记录锻炼的 GPS 数据
  • 营养：饮水记录
  • 配置文件：用户的基本个人资料信息
  • 设置：用户配置的设备和移动应用设置
  • 睡眠：经典睡眠日志和阶段睡眠日志

支持写入的数据类型：

您可以写入和修改以下数据类型的数据：

  • 活动和健身 ：锻炼
  • 健康指标和测量数据 ：体脂、体重
  • 配置文件
  • 设置
  • 睡眠

用于互动的主要端点

以下端点可用于管理订阅、用户以及健康和健身数据：

  • users：getIdentity、getProfile、getSettings、updateProfile 和 updateSettings 方法，用于身份和个人资料管理。
  • users.dataTypes.dataPoints：batchDelete、dailyRollUp、list、patch、reconcile 和 rollUp 方法，用于全面管理数据类型。