本頁提供 Google Fit API 版本的相關資訊。 變更記錄會依照日期列出版本,並包含任何新功能、錯誤修正或重大效能改善。
2021 年 8 月 2 日
寫入健康狀態資料類型現已全面開放給開發人員使用。存取健康資料類型的授權與所有其他資料類型一致。請按這裡瞭解詳情。
2021 年 4 月 27 日
在 2020 年 10 月 10 日公告的授權變更中,原先的違規處置有些許延遲。授權異動將於 2021 年 5 月 4 日開始實施。
《Google Fit 開發人員與使用者資料政策》將於 2021 年 5 月 4 日生效。實施 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
類型的工作階段。 - 如要偵測工作階段的精細程度,請插入類型類型的活動區隔:
- 如要讀取睡眠資料,請像平常的健身活動一樣,查詢睡眠活動的區隔。
- 如要插入睡眠資料,請建立