版本資訊

2026 年 5 月 26 日

新範圍

  • .ecg.readonly 讀取心電圖資料。
  • .irn.readonly 讀取 IRN 資料。

範圍名稱變更

將讀取/寫入範圍替換為 .writeonly。開發人員現在必須明確指定讀取和寫入權限。

  • .activity_and_fitness 現在是 .activity_and_fitness.writeonly
  • .health_metrics_and_measurements 現在是 .health_metrics_and_measurements.writeonly
  • .nutrition 現在是 .nutrition.writeonly
  • .profile 現在是 .profile.writeonly
  • .settings 現在是 .settings.writeonly
  • .sleep 現在是 .sleep.writeonly

全新資料類型

新增對下列資料類型的支援：

  • 活動與健身：active-energy-burned
  • ECG：electrocardiogram
  • 健康指標與測量：core-body-temperature、blood-glucose
  • IRN：irregular-rhythm-notification
  • 營養：food、food-measurement-unit、nutrition-log

新端點

Webhook

新增對下列 Webhook 功能的支援：

  • 手動訂閱支援 (訂閱者註冊時)。
  • 支援以下資料類型的通知：activityLevel、bloodGlucose、dailyRespiratoryRate、heartRateVariability、height、hydrationLog、nutritionLog、respiratoryRateSleepSummary、runVo2Max、sedentaryPeriod、timeInHeartRateZone。
  • 在 Google Cloud 控制台中支援自訂指標、快訊和訂閱者錯誤。
  • 如果與訂閱者的通訊中斷，系統最多會自動重試傳送失敗的 Webhook 通知 7 天。

說明文件更新重點

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 方法，可全面管理資料型別。