2026 年 3 月 24 日
Google Health API 發布公告
Google Health API 是新一代的 Fitbit Web API,專為我們重視的開發人員社群從頭打造。這個初始版本著重於在最常要求的資料類型中,與 Fitbit Web API 達成同等功能,並新增開發人員社群要求的功能。以下是目前可用的功能。
核心功能重點
- 簡化設定:直接透過熟悉的 Google Cloud 控制台註冊專案及管理 OAuth 用戶端 ID。
- 支援多種平台:以 Google OAuth2 程式庫為基礎建構,在所有主要程式設計語言和平台中順暢整合。
- 簡化資料存取權:使用新的範圍定義,將多種資料類型整合為單一易於管理的範圍。
- 各種資料類型都使用一致的端點:透過新的統一端點和篩選器支援功能,簡化程式設計歷程,並簡化所有資料類型的功能。
- 涵蓋多種資料類型:支援讀取及寫入多種資料類型。
- 即時通知:透過強化版 Webhook 支援功能即時接收最新資訊,包括自動建立訂閱項目和更豐富的通知訊息內容。
- 預設當日支援:預設使用清單端點擷取精細的當日資料,省去額外步驟。
- 完整說明文件套件:透過我們全新的完整說明文件快速上手,包括:
- 入門、API、遷移和疑難排解指南
- REST 完整參考指南
- 全新的 Google Health API 同位工具、程式碼範例和導覽式 Codelabs
支援的資料類型
這次發布的內容提供重要資料類型,確保您擁有建構創新健康解決方案所需的核心資訊。
支援讀取的資料類型:
- 活動與健身:活動分鐘數、活動區間分鐘數、活動強度、海拔高度、心率區間的卡路里、每日最大攝氧量、距離、運動、樓層數、跑步最大攝氧量、久坐時間、步數、心率區間時間、總卡路里、最大攝氧量
- 健康指標與測量結果:體脂肪、每日心率變異、每日心率區間、每日血氧濃度、每日呼吸速率、每日靜止心率、每日睡眠溫度變化、心率、心率變異、血氧濃度、呼吸速率睡眠摘要、體重
- 身分:傳回 Fitbit 使用者 ID 和 Google 使用者 ID
- 位置:以 TCX 格式顯示記錄的運動 GPS 資料
- 營養:飲水量記錄
- 個人資料:使用者的基本個人資料資訊
- 設定:使用者已設定裝置和行動應用程式設定
- 睡眠:傳統和睡眠階段記錄
支援寫入的資料類型:
您可以寫入及修改下列資料類型的資料:
- 活動與健身:運動
- 健康指標和測量資料:體脂肪、體重
- 個人資料
- 設定
- 睡眠
互動的主要端點
您可以使用下列端點管理訂閱項目、使用者和健康與健身資料:
users:用於身分和個人資料管理的getIdentity、getProfile、getSettings、updateProfile和updateSettings方法。users.dataTypes.dataPoints:batchDelete、dailyRollUp、list、patch、reconcile和rollUp方法,可全面管理資料型別。