Google Health API 数据类型

下表包含完整的数据类型列表,其中有多个列可帮助您了解每种类型在 Google Health API 中的表示方式,以及每种类型可用的范围。

表:Google Health API 数据类型
数据类型
  dataType
  filter 参数
记录
类型
可用
操作
范围 Webhook
支持
活跃分钟数
  active-minutes
  active_minutes
间隔 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
体脂率
  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
每日心率变异性
  daily-heart-rate-variability
  daily_heart_rate_variability
每天 list、reconcile health_metrics_and_measurements
每日心率区间
  daily-heart-rate-zones
  daily_heart_rate_zones
每天 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
运动
  exercise
  exercise
会话 list、get、reconcile、create、update、batchDelete activity_and_fitness
楼层数
  floors
  floors
间隔 reconcile、rollup、dailyRollup activity_and_fitness
心率
  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 nutrition
血氧饱和度
  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 sleep
步数
  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
间隔 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 移动应用或 Web 应用后,才能更新用户的数据。当 Fitbit 应用在移动设备上打开,并且两者之间有有效的数据连接且在蓝牙范围内时,Fitbit 设备和 Fitbit 移动应用可以每 15 分钟自动同步一次。如果用户使用 MobileTrack 跟踪活动,只要应用处于打开状态,MobileTrack 就会每小时同步一次。

距离标准

运动距离(例如 elevationGainMillimeters)以毫米为标准单位进行测量,原因如下:

  1. 保持数据精度:使用毫米的最重要原因是确保我们读取和提供的数据不会丢失任何精度。使用毫米等精细单位可以让我们以高精度表示测量值。
  2. 标准化:毫米是我们各项服务中设计的标准化单位 。这种一致性有助于确保与 API 不同部分互动的开发者获得统一的体验。
  3. 广泛的测量系统支持:无论开发者使用的是公制、英制还是其他测量系统,使用毫米等基本单位都可以让他们轻松转换为任何其他选定的单位。