卡路里和能量数据类型

Google Health API 提供用于跟踪用户卡路里和能量消耗的数据类型。这些类型用于衡量能量消耗的不同方面，包括总消耗量、活动消耗量和静息（基础）代谢率。

了解这些数据类型之间的差异，以确定哪些指标适合您的应用。

支持的数据类型

该 API 支持以下数据类型来衡量卡路里和能量消耗：

表：Google Health API 卡路里数据类型
数据类型
  dataType
  filter 参数		 记录
类型		 可用
操作		 范围 Webhook
支持		 真实零值
支持
活动消耗的能量
  active-energy-burned
  active_energy_burned 		间隔 list、reconcile、rollup、dailyRollup activity_and_fitness
基础消耗能量
  basal-energy-burned
  basal_energy_burned 		间隔 list、reconcile activity_and_fitness
基础代谢率
  basal-metabolic-rate
  basal_metabolic_rate 		示例 list、reconcile nutrition

以下部分提供了每种数据类型的技术详细信息，包括 REST 表示法示例和具体集成限制。

总卡路里数

“总卡路里数”是一种只读的派生数据类型，用于跟踪用户消耗的所有能量，包括基础代谢和活动能量，以千卡 (kcal) 为单位。该值根据活动能量消耗和用户的基础代谢率计算得出。

活动消耗的能量

“活动消耗的能量”表示用户在活动期间消耗的能量，不包括基础能量消耗，以千卡 (kcal) 为单位。

REST 表示法示例

{
  "startTime": "2026-04-20T08:00:00Z",
  "startUtcOffset": "0s",
  "endTime": "2026-04-20T08:30:00Z",
  "endUtcOffset": "0s",
  "dataSource": { ... },
  "kcal": 150.0
}

基础消耗能量

“基础消耗能量”表示用户在一段时间内因静息代谢而消耗的卡路里，以千卡 (kcal) 为单位。

注意： 此数据类型不支持汇总和每日汇总操作。如需获取每日基础能量值，请使用“基础代谢率”数据类型。

基础代谢率

“基础代谢率”用于衡量身体在正常静息状态下消耗的能量，以千卡/天 (kcal/day) 为单位。由于此比率会随着时间的推移而因身体更新（例如体重）而波动，因此 API 会将 BMR 记录为比率样本的时间序列。

开发者可以将 basal-metabolic-rate 样本中的 rateKcalPerDay 字段视为基础消耗能量的每日汇总的每日对应值。

REST 表示法示例

{
  "date": {
    "year": 2026,
    "month": 4,
    "day": 20
  },
  "dataSource": { ... },
  "rateKcalPerDay": 1650.0
}

指南

在应用中集成卡路里和能量指标时，请遵循以下指南：

  • 每日概览： 如需显示每日卡路里总消耗量，请请求 total-calories 数据类型的每日汇总。
  • 仅活动消耗量： 如需跟踪特定锻炼期间或全天消耗的卡路里（不包括静息代谢率），请查询 active-energy-burned。
  • 基础指标： 如需跟踪静息代谢率或基础代谢趋势，请查询 basal-metabolic-rate 以获取 BMR 值。将 BMR 样本视为用户静息能量消耗的每日基准。
上一页
数据类型索引