版本資訊

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:用於身分和個人資料管理的 getIdentitygetProfilegetSettingsupdateProfileupdateSettings 方法。
  • users.dataTypes.dataPointsbatchDeletedailyRollUplistpatchreconcilerollUp 方法,可全面管理資料型別。