Google Fit API 已淘汰，預計於 2026 年底終止服務。Google 提供多項健康與健身產品和服務，協助使用者在該 API 淘汰後繼續達成自身目標。
注意：Google Fit API (包括 REST API) 僅支援至 2026 年底。建議您改用 Google Health API 進行雲端整合，或使用健康資料同步追蹤步數和開發行動優先應用程式。
下列指南將說明根據 Google Fit API 的使用方式，遷移至哪個服務。
建議的遷移路徑
請根據應用程式類型和特定資料需求選擇 API。
依應用程式類型
| 應用程式類型 | 建議路徑 | 主要原因 |
|---|---|---|
| 步數追蹤應用程式 | Health Connect | 以行動裝置為中心，讀取來自各種來源的匯總步數資料。 |
| 健身智慧手環隨附應用程式 | Google Health API | 以網路為中心的平台，需要 OAuth 才能整合使用者。 |
| 健康與健身平台 | Google Health API 和健康資料同步 | 使用 Google Health API 存取 Fitbit/Google 裝置資料，並使用「健康資料同步」存取裝置端的彙整資料。 |
透過目前的整合服務
| 目前整合 | 建議路徑 | 適用地區 |
|---|---|---|
| Google Fit (Android 和 REST API) | Google Health API | 可使用 |
| 讀取行動裝置步數 (使用 Google Fit Recording API) | Health Connect | 可使用 |
| Wear OS 的 Fit API | 健康照護服務 | 可使用 |
| Fitbit Web API | Google Health API | 可使用 |
| 行動裝置上的 Recording API | Health Connect | 可使用 |
| Health Connect | 保留現有整合項目或新增 Google Health API | 可使用 |
技術比較
以下章節將從技術層面比較 Google Fit API、Google Health API 和健康資料同步，協助您選擇合適的遷移路徑。
Fit API 與 Google Health API 的比較
如果您的應用程式是網頁式平台，或需要伺服器對伺服器 (S2S) 互動，請使用這個路徑。
| 功能 | Fit API (Android/REST) | Google Health API |
|---|---|---|
| 專案設定 | Google Cloud 控制台 | 建立 Google Cloud 專案 |
| OAuth 設定 | Android 或網頁應用程式類型 | 網頁應用程式類型 |
| 資料架構 | com.google 前置字元類型 |
統一的 Google Health API 資料類型 |
| 應用程式註冊 | 建立 Google Cloud 專案 | 建立 Google Cloud 專案並啟用 Google Health API |
Fit API 與健康資料同步
如果 Android 應用程式以行動裝置優先，且會讀取本機裝置指標，請使用這個路徑。
| 功能 | Android 適用的 Fit API | Health Connect |
|---|---|---|
| 註冊 | Google Cloud Console | Play 商店專案和健康應用程式聲明 |
| 驗證 | 必須使用 OAuth 2.0 | 不需 OAuth (裝置端權限) |
| 資料儲存 | 以雲端為中心 | 以裝置為中心 (裝置端) |
| 目標對象 | 舊版 Android 開發人員 | 當代 Android 行動開發人員 |
| 權限 | OAuth 範圍 | Android 資訊清單權限 |
Fit API 整合
以下各節提供從各個 Google Fit API 遷移的指引。如果您的整合項目也包含連結至 Google Fit 應用程式的 UI 元素，請參閱 Fit 應用程式整合指南，瞭解其他指引。
應用程式使用 Fit Recording API 記錄步數
Fit Recording API 可讓應用程式透過建立訂閱的方式，自動以較為省電的方式儲存感應器資料。每項訂閱都會將 Android 應用程式連結至特定健身資料類型或資料來源，而 Step 資料類型通常用於記錄步數。
如要從 Fit Recording API 遷移資料，請按照下列步驟操作：
| 手機 | Wear |
|
使用健康照護服務：
如要進一步瞭解兩者之間的差異，請參閱 健康照護服務說明文件。 |
應用程式使用 History API 讀取或寫入健身商店的資料
History API 可讓應用程式在健身儲存庫執行大量操作，包括讀取、插入、更新及刪除過去的健康與保健資料。
如要從 History API 遷移資料，請按照下列步驟操作：
| 手機 | Wear |
|
不適用。使用行動應用程式中的健康資料同步，不要使用穿戴式裝置。 |
應用程式使用感應器 API 顯示即時健身資料
感應器 API 可讓您即時在應用程式中讀取原始感應器資料。感應器 API 會執行下列作業：
- 列出裝置和隨附裝置上可用的資料來源。
- 註冊監聽程式，以接收原始感應器資料。
- 取消註冊監聽器，使其不再接收原始感應器資料。
如要從感應器 API 遷移資料，請按照下列步驟操作：
| 手機 | Wear |
|
在 Wear OS 裝置上使用健康照護服務：
|
使用 Session API 提供活動摘要的應用程式
工作階段是指使用者進行健身活動的時段。
工作階段 API 可讓應用程式在健身商店中建立工作階段。
如要從 Session API 遷移資料，請按照下列步驟操作：
| 手機 | Wear |
|
開始/停止：不適用。應用程式應於內部追蹤進行中的工作階段狀態。 讀取/寫入： 改用 Google Health API。 |
開始/停止：使用健康照護服務 (ExerciseClient) 讀取/寫入：透過行動應用程式使用「健康資料同步」。 對於特定的工作流程，我們建議採取下列做法：
|
使用 Goals API 的應用程式
目標是指使用者在 Google Fit 應用程式中，為步數和心肺強化分數等指標設定的目標。Fit 平台使用 目標 API 記錄目標並追蹤每日活動情況。
| 手機 | Wear |
| 沒有可用的替代 API。 | 沒有可用的替代 API。 |
使用 BLE API 的應用程式
您的應用程式可以使用 BLE API 尋找可用的藍牙低功耗 (BLE) 裝置，並將感應器資料插入 Google Fit 平台。
如要從 BLE API 遷移資料，請按照下列步驟操作：
| 手機 | Wear |
| 直接使用 Android Bluetooth API。 | 直接使用 Android Bluetooth API。 |
已淘汰的功能
以下功能沒有直接的 API 替代方案。使用建議的 Android 標準 API：
- 感應器 API：使用 Android Sensors 架構或整合式位置預測提供工具 API，取得即時原始資料。
- 目標 API：沒有可用的替代 API。在應用程式邏輯中管理目標追蹤和每日活動目標。
- 藍牙低功耗 (BLE) API：直接使用 Android Bluetooth API 與硬體通訊。
Fit 應用程式整合
如果您的應用程式會連線至 Google Fit 以分享資料，請按照下列章節的指引，將現有和新使用者遷移至「健康資料同步」或 Google Health API：
現有的應用程式使用者
如果應用程式 UI 包含使用者連結 Google Fit 的方式 (或應用程式列在「與 Google Fit 整合的應用程式」清單中)，您可以繼續為現有使用者維護 Fit 應用程式整合功能。
我們會持續更新這個專區，提供有關停用 Google 健身應用程式整合功能的資訊，以及維持使用者體驗的最佳做法。在這段期間，歡迎與我們聯絡。
| 檢查正確做法 | 關閉錯誤做法 |
| 在應用程式中提供「健康資料同步」或 Google Health API 做為新選項。
著重於使用者優勢，例如更豐富的資料和洞察資訊、隱私權和安全性。
|
請使用者解除與 Google Fit 的連結。
|
新的應用程式使用者
為了讓新的應用程式使用者享有類似的體驗，我們建議整合健康資料同步或 Google Health API。
「健康資料同步」提供新的資料來源和類型，讓您為使用者提供更豐富的體驗，並將資料安全地儲存在裝置端。Google 健康資料 API 提供以網路為中心的平台，可存取 Fitbit 和 Google 裝置資料。
| 檢查正確做法 | 關閉錯誤做法 |
| 在應用程式的設定流程中加入「健康資料同步」或 Google Health API。 | 在「健康資料同步」推出後，提供 Google Fit 做為使用者可連結的應用程式。 |