Google 健身 API 已废弃，计划于 2026 年底终止服务。Google 提供了多种健康与健身产品和服务，可帮助您的用户在废弃后继续实现目标。
注意 ：Google 健身 API（包括 REST API）的支持将持续到 2026 年底。我们建议您迁移到 Google Health API（适用于基于云的集成）或健康数据共享（适用于步数跟踪和移动优先应用）。
以下指南将根据您使用 Google 健身 API 的方式，向您展示要迁移到的服务。
推荐的迁移路径
您应根据应用类型和具体数据需求选择 API。
按应用类型
| 应用类型 | 推荐路径 | 主要原因 |
|---|---|---|
| 步数跟踪应用 | Health Connect | 以移动设备为中心，从各种来源读取汇总的步数数据。 |
| 运动手环配套应用 | Google Health API | 以 Web 为中心的平台，需要 OAuth 进行用户集成。 |
| 健康与健身平台 | Google Health API 和 健康数据共享 | 使用 Google Health API 获取 Fitbit/Google 设备数据，使用健康数据共享获取设备上的汇总数据。 |
按当前集成
| 当前集成 | 推荐路径 | 可用性 |
|---|---|---|
| Google 健身（Android 和 REST API） | Google Health API | 可用 |
| 读取移动设备步数（使用 Google 健身 Recording API） | Health Connect | 可用 |
| Wear OS 上的 Fit API | 健康服务 | 可用 |
| Fitbit Web API | Google Health API | 可用 |
| 移动版 Recording API | Health Connect | 可用 |
| Health Connect | 保留现有集成或添加 Google Health API | 可用 |
技术比较
以下部分对 Google 健身 API、Google Health API 和健康数据共享进行了技术比较，以帮助您选择合适的迁移路径。
Fit API 与 Google Health API
如果您的应用是基于 Web 的平台或需要服务器到服务器 (S2S) 交互，请使用此路径。
| 功能 | Fit API（Android/REST） | Google Health API |
|---|---|---|
| 项目设置 | Google Cloud 控制台 | 创建 Google Cloud 项目 |
| OAuth 配置 | Android 或 Web 应用类型 | Web 应用类型 |
| 数据架构 | 以 com.google 为前缀的类型 |
统一的 Google Health API 数据类型 |
| 应用注册 | 创建 Google Cloud 项目 | 创建 Google Cloud 项目并启用 Google Health API |
Fit API 与 Health Connect
对于读取本地设备指标的移动优先 Android 应用，请使用此路径。
| 功能 | 适用于 Android 的 Fit API | Health Connect |
|---|---|---|
| 注册 | Google Cloud 控制台 | Play 商店项目和健康应用声明 |
| 身份验证 | 需要 OAuth 2.0 | 无需 OAuth（设备上的权限） |
| 数据存储 | 以云为中心 | 以设备为中心（设备上） |
| 受众群体 | 旧版 Android 开发者 | 新式 Android 移动应用开发者 |
| 权限 | OAuth 范围 | Android 清单权限 |
Fit API 集成
以下部分提供了有关从每个 Google 健身 API 进行迁移的指南。如果您的集成还包含连接到 Google 健身应用的界面元素，请参阅 Fit 应用集成指南 以获取更多指导。
使用 Fit Recording API 记录步数的应用
Fit Recording API 可让应用通过创建订阅，请求以省电的方式自动存储传感器数据。每个订阅都会将 Android 应用连接到特定的健身数据类型或数据源，而 Step 数据类型通常用于记录步数。
请按以下步骤从 Fit Recording API 迁移：
| 手机 | Wear |
|
使用健康服务：
如需详细了解这两者之间的区别，请参阅健康服务相关文档。 |
使用 History API 读取或写入健身数据存储区数据的应用
History API 可让应用对 健身数据存储区执行批量操作。这些操作包括读取、插入、更新和删除健康和健身方面的历史数据。
请按以下步骤从 History API 迁移：
| 手机 | Wear |
|
不适用。通过移动应用（而非穿戴式设备）使用健康数据共享。 |
使用 Sensor API 显示实时健身数据的应用
Sensor API 可用于在应用中实时读取原始传感器数据。Sensor API 执行以下操作：
- 列出设备和配套设备上可用的数据源。
- 注册用于接收原始传感器数据的监听器。
- 取消注册监听器，使其不再接收原始传感器数据。
请按以下步骤从 Sensor API 迁移：
| 手机 | Wear |
|
使用 传感器、 一体化位置信息提供程序 API |
在 Wear OS 上使用 健康服务 ：
|
使用 Session API 提供活动摘要的应用
会话表示用户进行某项健身活动的时间间隔。
Session API 可让应用在健身 数据存储区中创建会话。
请按以下步骤从 Session API 迁移：
| 手机 | Wear |
|
开始/停止：不适用。应用应在内部跟踪正在进行的会话的状态。 读/写： 过渡到 Google Health API。 |
开始/停止：使用健康服务 (ExerciseClient) 读/写：通过移动应用使用 Health Connect。 关于具体工作流程，我们的建议如下：
|
使用 Goals API 的应用
目标是指用户可以在 Google 健身应用中为自己的指标（例如步数和心率积分）设置的目标。Google 健身平台使用 Goals API 记录用户的目标，并对照这些目标跟踪用户每天的活动 。
| 手机 | Wear |
| 没有可用的替代 API。 | 没有可用的替代 API。 |
使用 BLE API 的应用
应用可以使用 BLE API 查找可用的低功耗蓝牙 (BLE) 设备，并将传感器数据插入 Google 健身平台中。
请按以下步骤从 BLE API 迁移：
| 手机 | Wear |
| 直接使用 Android Bluetooth API。 | 直接使用 Android Bluetooth API。 |
已弃用的功能
以下功能没有直接的 API 替代方案。请使用推荐的 Android 标准 API：
- Sensor API：使用 Android Sensors 框架或 Fused Location Provider API 获取实时原始数据。
- Goals API：没有可用的替代 API。在应用逻辑中管理目标跟踪和每日活动目标。
- 低功耗蓝牙 (BLE) API：直接使用 Android Bluetooth API 与硬件通信。
Fit 应用集成
如果您的应用连接到 Google 健身以进行数据共享，请按照以下部分中的指南将现有用户和新用户迁移到健康数据共享或 Google Health API：
应用的现有用户
如果您的应用界面包含用户连接到 Google 健身的方式（或者您的 应用包含在与 Google 健身应用搭配使用的应用列表中），您可以 继续为当前用户维护 Fit 应用集成。
我们会及时更新此部分，提供有关何时废弃 Fit 应用集成的信息，以及维护用户体验的最佳方案。同时，您可以与我们联系。
| check执行此操作 | close请勿执行此操作 |
| 在应用中提供 Health Connect 或 Google Health API 作为新选项。 重点介绍用户权益，例如更丰富的数据和洞见、隐私和 安全性。
|
要求用户断开与 Google 健身的连接。
|
应用的新用户
如需为应用的新用户提供类似体验，我们建议您构建与 健康数据共享 或 Google Health API 的集成。
健康数据共享提供对新数据源和类型的访问权限，可为用户提供更丰富的体验，并将数据安全地存储在设备上。Google Health API 为 Fitbit 和 Google 设备数据提供了一个以 Web 为中心的平台。
| check执行此操作 | close请勿执行此操作 |
| 在应用的 设置流程中添加健康数据共享或 Google Health API。 | 在健康数据共享 可用后，提供 Fit 作为用户可以连接的应用。 |