Google 健身 API 的支持将持续到 2026 年底。Google 提供了多种健康和保健产品和服务，可帮助您的用户在旧版功能弃用后继续实现目标。
注意：Google 健身 API（包括 REST API）的支持将仅持续到 2026 年底。我们建议您迁移到 Google Health API（用于基于云的集成）或健康数据共享（用于步数跟踪和移动优先应用）。
以下指南介绍了应根据您使用 Google 健身 API 的方式迁移到哪个服务。
推荐的迁移路径
您应根据应用类型和具体的数据需求来选择 API。
按应用类型
| 应用类型 | 推荐的路径 | 主要原因 |
|---|---|---|
| 步数追踪应用 | 健康数据共享 | 以移动设备为中心，读取来自各种来源的汇总步数数据。 |
| 运动手环配套应用 | Google Health API | 以 Web 为中心的平台，需要 OAuth 进行用户集成。 |
| 健康与健身平台 | Google Health API 和健康数据共享 | 使用 Google Health API 获取 Fitbit/Google 设备数据，使用“健康数据共享”获取设备上的汇总数据。 |
通过当前集成
| 当前集成 | 推荐的路径 | 可用性 |
|---|---|---|
| Fit History API 和 Fit Session API | Google Health API | 可用 |
| 读取移动设备上的步数（使用 Google 健身 Recording API） | 健康数据共享 | 可用 |
| Wear OS 上的 Fit API | 健康服务 | 可用 |
| Fitbit Web API | Google Health API | 可用 |
| 健康数据共享 | 保留现有集成或添加 Google Health API | 可用 |
技术比较
以下部分将对 Google 健身 API、Google Health API 和健康数据共享进行技术比较，以帮助您选择合适的迁移途径。
Fit API 与 Google Health API
如果您的应用是基于 Web 的平台或需要服务器到服务器 (S2S) 互动，请使用此途径。
| 功能 | Fit API (Android/REST) | Google Health API |
|---|---|---|
| 项目设置 | Google Cloud Console | 创建 Google Cloud 项目 |
| OAuth 配置 | Android 或 Web 应用类型 | Web 应用类型 |
| 数据架构 | 带 com.google 前缀的类型 |
统一了 Google Health API 数据类型 |
| 应用注册 | 创建 Google Cloud 项目 | 创建 Google Cloud 项目并启用 Google Health API |
Fit API 与健康数据共享
对于读取本地设备指标的移动优先 Android 应用，请使用此路径。
| 功能 | 适用于 Android 的 Fit API | 健康数据共享 |
|---|---|---|
| 注册 | Google Cloud Console | Play 商店项目和健康类应用声明 |
| 身份验证 | 需要 OAuth 2.0 | 无需 OAuth（设备端权限） |
| 数据存储 | 以云为中心 | 以设备为中心（设备端） |
| 受众群体 | 旧版 Android 开发者 | Modern Android 移动开发者 |
| 权限 | OAuth 范围 | Android 清单权限 |
Fit API 集成
以下部分提供了有关从各个 Google Fit 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 |
|
在 Wear OS 设备上使用健康服务：
|
使用 Session API 提供活动摘要的应用
会话表示用户进行某项健身活动的时间间隔。
Session API 可让应用在健身数据存储区中创建会话。
请按照以下步骤从 Session API 迁移：
| 手机 | Wear |
|
开始/停止：不适用。应用应在内部跟踪正在进行的会话的状态。 |
开始/停止：使用健康服务 (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 蓝牙 API 与硬件通信。
Fit 应用集成
如果您的应用连接到 Google 健身以进行数据共享，请按照以下部分中的指南将现有用户和新用户迁移到健康数据共享或 Google Health API：
应用的现有用户
如果您的应用界面包含供用户连接到 Google 健身的方式（或者您的应用包含在支持 Google 健身的应用列表中），您可以继续为现有用户维护您的 Google 健身应用集成。
我们会及时更新本部分，提供有关何时弃用 Fit 应用集成的信息，以及维护用户体验的最佳方案。在此期间，您可以与我们联系。
| 检查执行此操作 | 关闭不建议的做法 |
| 在您的应用中提供 健康数据共享 或 Google Health API 作为新选项。 侧重于用户福利，例如更丰富的数据和数据分析、隐私保护和安全性。
|
要求用户取消与 Google 健身的关联。
|
应用的新用户
为了向应用的新用户提供类似体验，我们建议您与健康数据共享或 Google Health API 集成。
健康数据共享可访问新的数据源和数据类型，从而为用户提供更丰富的体验，同时将数据安全地存储在设备上。Google Health API 为 Fitbit 和 Google 设备数据提供了一个以 Web 为中心的平台。
| 检查执行此操作 | 关闭不建议的做法 |
| 在应用的设置流程中添加健康数据共享或 Google Health API。 | 在健康数据共享可用后，将 Google Fit 作为用户可以关联的应用提供。 |