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 数据
- 营养：饮水量记录
- 个人资料：用户的基本个人资料信息
- 设置：用户配置的设备和移动应用设置
- 睡眠：传统睡眠记录和睡眠阶段记录
支持写入的数据类型：
您可以写入和修改以下数据类型的数据：
- 活动和健身：锻炼
- 健康指标和测量数据：体脂、体重
- 配置文件
- 设置
- Sleep
关键互动端点
以下端点可用于管理订阅、用户以及健康和健身数据：
users：用于身份和个人资料管理的getIdentity、getProfile、getSettings、updateProfile和updateSettings方法。users.dataTypes.dataPoints：batchDelete、dailyRollUp、list、patch、reconcile和rollUp方法，用于全面管理数据类型。