Google Health API 資料類型

下表列出所有資料類型,並提供多個資料欄,協助您瞭解 Google Health API 中各類型的表示方式,以及各類型適用的範圍。

表格:Google Health API 資料型別
資料類型
  dataType
  filter 參數
Record
type
可用的
作業
範圍 Webhook
支援
消耗的活動熱量
  active-energy-burned
  active_energy_burned
時間間隔 list、reconcile、rollup、dailyRollup activity_and_fitness
活動分鐘數
  active-minutes
  active_minutes
時間間隔 list、reconcile、rollup、dailyRollup activity_and_fitness
活動區間分鐘數
  active-zone-minutes
  active_zone_minutes
時間間隔 list、reconcile、rollup、dailyRollup activity_and_fitness
活動等級
  activity-level
  activity_level
時間間隔 list、reconcile activity_and_fitness
海拔高度
  altitude
  altitude
時間間隔 list、reconcile、rollup、dailyRollup activity_and_fitness
血糖
  blood-glucose
  blood_glucose
範例 list、get、reconcile、rollup、dailyRollup health_metrics_and_measurements
體脂肪
  body-fat
  body_fat
範例 list、get、reconcile、rollup、dailyRollup、create、update、batchDelete health_metrics_and_measurements
心率區間消耗的熱量
  calories-in-heart-rate-zone
  calories_in_heart_rate_zone
時間間隔 rollup、dailyRollup activity_and_fitness
核心體溫
  core-body-temperature
  core_body_temperature
範例 list、get、reconcile、rollup、dailyRollup health_metrics_and_measurements
每日心率變異
  daily-heart-rate-variability
  daily_heart_rate_variability
每日 list、reconcile health_metrics_and_measurements
每日心率區間
  daily-heart-rate-zones
  daily_heart_rate_zones
每日 list、reconcile health_metrics_and_measurements
每日血氧濃度
  daily-oxygen-saturation
  daily_oxygen_saturation
每日 list、reconcile health_metrics_and_measurements
每日呼吸速率
  daily-respiratory-rate
  daily_respiratory_rate
每日 list、reconcile health_metrics_and_measurements
每日靜止心率
  daily-resting-heart-rate
  daily_resting_heart_rate
每日 list、reconcile health_metrics_and_measurements
每日睡眠溫度變化
  daily-sleep-temperature-derivations
  daily_sleep_temperature_derivations
每日 list、reconcile health_metrics_and_measurements
每日最大攝氧量
  daily-vo2-max
  daily_vo2_max
每日 list、reconcile activity_and_fitness
距離
  distance
  distance
時間間隔 list、reconcile、rollup、dailyRollup activity_and_fitness
心電圖 (ECG)
  electrocardiogram
  electrocardiogram
工作階段 list ecg
運動
  exercise
  exercise
工作階段 list、get、reconcile、create、update、batchDelete activity_and_fitness
樓層數
  floors
  floors
時間間隔 reconcile、rollup、dailyRollup activity_and_fitness
美食
  food
  food
食物 list、get 營養學
食品測量單位
  food-measurement-unit
  food_measurement_unit
食物 list、get 營養學
心率
  heart-rate
  heart_rate
範例 list、reconcile、rollup、dailyRollup health_metrics_and_measurements
心率變異
  heart-rate-variability
  heart_rate_variability
範例 list、reconcile health_metrics_and_measurements
身高
  height
  height
範例 list、get、reconcile、create、update、batchDelete health_metrics_and_measurements
飲水量記錄
  hydration-log
  hydration_log
工作階段 list、get、reconcile、rollup、dailyRollup、create、update、batchDelete 營養學
心律不整通知
  irregular-rhythm-notification
  irregular_rhythm_notification
工作階段 list irn
營養記錄
  nutrition-log
  nutrition_log
範例 list、get、reconcile、rollup、dailyRollup、create、update、batchDelete 營養學
血氧濃度
  oxygen-saturation
  oxygen_saturation
範例 list、reconcile health_metrics_and_measurements
呼吸速率睡眠摘要
  respiratory-rate-sleep-summary
  respiratory_rate_sleep_summary
範例 list、reconcile health_metrics_and_measurements
跑步最大攝氧量
  run-vo2-max
  run_vo2_max
範例 list、reconcile、rollup、dailyRollup activity_and_fitness
久坐時間
  sedentary-period
  sedentary_period
時間間隔 list、reconcile、rollup、dailyRollup activity_and_fitness
睡眠
  sleep
  sleep
工作階段 list、get、reconcile、create、update、batchDelete 睡眠
步驟
  steps
  steps
時間間隔 list、reconcile、rollup、dailyRollup activity_and_fitness
游泳距離資料
  swim-lengths-data
  swim_lengths_data
時間間隔 list、reconcile、rollup、dailyRollup activity_and_fitness
在心率區間的時間
  time-in-heart-rate-zone
  time_in_heart_rate_zone
時間間隔 list、reconcile、rollup、dailyRollup activity_and_fitness
總熱量
  total-calories
  total_calories
時間間隔 rollup、dailyRollup activity_and_fitness
最大攝氧量
  vo2-max
  vo2_max
範例 list、reconcile activity_and_fitness
重量
  weight
  weight
範例 list、get、reconcile、rollup、dailyRollup、create、update、batchDelete health_metrics_and_measurements

資料可用性

使用者必須同步活動追蹤器,或在 Fitbit 行動或網頁應用程式中手動輸入新資料,才能更新資料。Fitbit 應用程式在行動裝置上開啟時,Fitbit 裝置和 Fitbit 行動應用程式每 15 分鐘會自動同步一次,前提是兩者之間有作用中的資料連線,且在藍牙範圍內。如果使用者使用 MobileTrack 追蹤活動,只要應用程式處於開啟狀態,MobileTrack 就會每小時同步一次。

第三方存取權

Fitbit 裝置無法直接與第三方應用程式或服務通訊。這些裝置的設計宗旨是專門與 Fitbit 行動應用程式通訊及同步。

只要開啟 Fitbit 應用程式,裝置就會全天自動同步資料。如果藍牙已啟用,且應用程式在背景執行,裝置每 15 分鐘就會同步一次。同步程序完成後,第三方服務就能透過 Google Health API 存取資料。

距離標準

運動距離 (例如 elevationGainMillimeters) 會以公釐做為標準單位,原因如下:

  1. 維持資料精確度:使用公釐的最重要原因,是確保我們讀取及提供的資料不會失去任何精確度。使用公釐等精細單位,可讓我們以高精確度表示測量結果。
  2. 標準化:毫米是我們服務中設計的標準單位。這項一致性可確保開發人員與 API 不同部分互動時,都能獲得一致的體驗。
  3. 廣泛支援測量系統:使用毫米等基本單位,開發人員就能輕鬆轉換為任何其他所選單位,無論是公制、英制或其他測量系統都適用。