本頁包含 Google Fit API 版本的相關資訊。 變更記錄會按日期列出版本,且包含任何新功能、錯誤修正或重大效能改善項目。
2021 年 8 月 2 日
現已正式發布:寫入健康資料類型。健康資料類型的存取權授權與其他資料類型一致。詳情請參閱本文。
2021 年 4 月 27 日
在 2020 年 10 月 10 日公布的授權變更中,我們已稍微延遲。授權變更現在將於 2021 年 5 月 4 日強制執行。
Google Fit 開發人員和使用者資料政策也將於 2021 年 5 月 4 日開始強制執行。應用程式驗證是 Google Fit 開發人員政策的強制執行過程中的一部分,首先會以相對課程開始。
2020 年 10 月 19 日
我們一直致力為開發人員和使用者加強 Google Fit 的安全性和隱私權,因此針對 Google Fit 政策和 API 做了一些變更:
- 我們推出了新的 Google Fit 開發人員和使用者資料政策。 請詳閱政策,並視需要修正您的應用程式和服務。
- 寫入存取權現在僅允許應用程式讀取其寫入的資料。如要繼續從 Google Fit 平台讀取其他應用程式寫入的資料,請更新您的程式碼,要求相關資料類型的讀取存取權範圍。
- 心率資料有專屬的範圍。
- 睡眠資料有專屬的範圍和新的資料類型。
- 使用
SessionsClient
時,您需要使用FitnessOptions
中的適當方法,指定應用程式需要存取的工作階段類型。
自 2020 年 10 月 19 日起,開發人員就能使用這些對 API 的異動。這項措施將從 2021 年 4 月 27 日起開始強制執行。
如需這些變更的詳細資訊與操作說明,請參閱這篇文章。
2019 年 3 月 21 日
Google Fit 應用程式現在會顯示寫入 Android API 的睡眠時段。進一步瞭解如何寫入及讀取睡眠資料。
2018 年 11 月 19 日
我們對 Google Fit API 進行了以下變更:
com.google.location.sample
和com.google.location.bounding_box
資料類型的讀取要求,只會傳回已寫入資料的相同應用程式的資料。
2018 年 9 月 26 日
Google Play 服務健身 16.0.0 提供兩種新資料類型及其各自的匯總:
在 maven.google.com 上發布的構件
- com.google.android.gms:play-services-fitness:16.0.0
2017 年 11 月
Google Play 服務 11.6.0 版推出下列 Google Fit 新功能:
- 為新的
GoogleApi
用戶端更新 Fitness API,以自動管理服務連線,使用較少樣板程式碼:- 新增了
BleClient
類別和Fitness.getBleClient()
方法。BleClient
可讓您在 Google Fit 中掃描、聲明及使用藍牙低功耗裝置。 - 新增了
ConfigClient
類別和Fitness.getConfigClient()
方法。ConfigClient
提供了進入 Google Fit 中自訂資料類型和設定的進入點。 - 新增了
GoalsClient
類別和Fitness.getGoalsClient()
方法。GoalsClient
可提供進入點,用於讀取 Google Fit 使用者建立的健身Goal
。 - 新增了
HistoryClient
類別和Fitness.getHistoryClient()
方法。HistoryClient
提供在 Google Fit 中插入、刪除及讀取資料的進入點。 - 新增了
RecordingClient
類別和Fitness.getRecordingClient()
方法。RecordingClient
提供了進入點,可讓使用者在 Google Fit 中啟用低耗電模式收集感應器資料的背景收集功能。 - 新增了
SensorsClient
類別和Fitness.getSensorsClient()
方法。SensorsClient
提供進入點,可在本機和已連結的裝置上公開不同的健身資料來源,並為事件監聽器提供現場活動。 - 新增了
SessionsClient
類別和getSessionsClient
方法。SessionsClient
提供了在 Google Fit 中建立及管理使用者活動的Session
進入點。
- 新增了
2015 年 5 月
Google Play 服務 7.5 版推出下列 Google Fit 新功能:
- 移動的距離和消耗的卡路里計算適用於訂閱。
- 只要裝置上的應用程式訂閱資料,Fit 平台就會開始追蹤距離和卡路里資料。如要進一步瞭解如何訂閱資料類型,請參閱「記錄健身資料」。
- 使用 Sensors API 無法即時提供這項資料。
- Fit 平台現在可以使用
com.google.activity.exercise
資料類型儲存例行運動資料,例如二頭肌如要進一步瞭解 Fit 可儲存的運動,請參閱WorkoutExercises
。
2015 年 4 月
Google Play 服務 7.3 版推出下列 Google Fit 新功能:
- Fit 平台現在可以使用
com.google.fitness
資料類型追蹤營養資料。com.google.calories.consumed
資料類型現已淘汰。您可以使用com.google.fitness.item
資料類型來記錄卡路里消耗量。- 如要進一步瞭解資料類型,請參閱「健身資料類型」。
- 開發人員可以擷取每日匯總步數,用於 Android Wear 錶面等區域。詳情請參閱「讀取每日總資料」。
2015 年 3 月
Google Play 服務 7.0 推出下列 Google Fit 新功能:
- Google Fit API 現已經過模組化,以便您可以選擇在應用程式中加入哪些功能。這項變更可以大幅減少啟用 Google Fit 的應用程式所需要的記憶體需求,並會影響您存取 API 的方式。如要進一步瞭解如何更新程式碼,請參閱「連結健身服務」。
- Fit 平台現在會計算距離。如要存取資料,請使用
com.google.distance.delta
資料類型。如要進一步瞭解資料類型,請參閱「健身資料類型」。 - 開發人員現在可以讀取及寫入精細的睡眠資料。包括淺層睡眠、深層睡眠、REM 睡眠和清醒活動。這些精細的活動類型已新增至
FitnessActivities
列舉類型。- 如要插入睡眠資料,請建立
FitnessActivities.SLEEP
類型的工作階段。 - 如要偵測工作階段的精細程度,請插入以下類型的活動區隔:
- 如要讀取睡眠資料,請查詢睡眠活動區隔的睡眠時段,就像查詢一般健身活動一樣。
- 如要插入睡眠資料,請建立