版本資訊

2026 年 4 月 14 日

全新資料類型

  • 活動與健身：swim-lengths-data
  • 健康指標與測量：height

新端點

Webhook 支援

  • 訂閱者註冊時自動建立訂閱項目。
  • 使用 project.subscribers 端點手動管理訂閱項目
  • 支援的通知資料類型包括 activeZoneMinutes、altitude、bodyFat、caloriesInHeartRateZone、dailyHeartRateVariability、dailyHeartRateZones、dailyOxygenSaturation、dailyRestingHeartRate、dailySleepTemperatureDerivations、distance、exercise、floors、heartRate、sleep、steps、totalCalories 和 weight。

其他功能

  • Github 上的 REST 程式庫：Google Health API REST 程式庫適用於 Github 專案「Google APIs」中包含的所有支援的用戶端程式庫。
  • 支援 API Explorer：您可以使用參考文件內建的 API Explorer 呼叫端點。
  • 支援 OAuth Playground：Google Health API 第 4 版已列在 OAuth 2.0 Playground 中，這個工具可讓您呼叫支援 Google OAuth 程式庫的端點。

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 同位工具、程式碼範例和導覽式程式碼研究室

支援的資料類型

這次發布的內容提供重要資料類型，確保您擁有建構創新健康解決方案所需的核心資訊。

支援讀取的資料類型：

  • 活動與健身：活動分鐘數、活動區間分鐘數、活動強度、海拔高度、心率區間的卡路里、每日最大攝氧量、距離、運動、樓層數、跑步最大攝氧量、久坐時間、步數、心率區間時間、總卡路里、最大攝氧量
  • 健康指標與測量：體脂肪、每日心率變異、每日心率區間、每日血氧濃度、每日呼吸速率、每日靜止心率、每日睡眠體溫變化、心率、心率變異、血氧濃度、呼吸速率睡眠摘要、體重
  • 身分：傳回 Fitbit 使用者 ID 和 Google 使用者 ID
  • 位置：以 TCX 格式顯示記錄的運動 GPS 資料
  • 營養：飲水量記錄
  • 個人資料：使用者的基本個人資料資訊
  • 設定：使用者已設定裝置和行動應用程式設定
  • 睡眠：傳統和睡眠階段記錄

支援寫入的資料類型：

您可以寫入及修改下列資料類型的資料：

  • 活動與健身：運動
  • 健康指標和測量資料：體脂肪、體重
  • 個人資料
  • 設定
  • 睡眠

互動的主要端點

您可以使用下列端點管理訂閱項目、使用者和健康與健身資料：

  • users：用於身分和個人資料管理的 getIdentity、getProfile、getSettings、updateProfile 和 updateSettings 方法。
  • users.dataTypes.dataPoints： batchDelete、dailyRollUp、list、patch、reconcile 和 rollUp 方法，可全面管理資料型別。