卡路里和能量数据类型

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

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

支持的数据类型

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

表：Google Health API 卡路里数据类型
数据类型
  dataType
  filter 参数		 记录
类型		 可用
操作		 范围 Webhook
支持		 真实零值
支持
活动消耗的能量
  active-energy-burned
  active_energy_burned 		间隔 list、reconcile、rollup、dailyRollup .activity_and_fitness.readonly
.activity_and_fitness.writeonly
总卡路里数
  total-calories
  total_calories 		间隔 rollup、dailyRollup .activity_and_fitness.readonly
.activity_and_fitness.writeonly

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

总卡路里数

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

对 total-calories 数据类型的查询必须包含时间间隔过滤器（例如 total_calories.interval.start_time 或 total_calories.interval.civil_start_time）。这些查询的最大范围为 14 天。

查询示例

如需查询 total-calories 数据类型，请向 list 端点发送包含间隔过滤器的请求：

请求

GET https://health.googleapis.com/v4/users/me/dataTypes/total-calories/dataPoints?filter=total_calories.interval.start_time >= "2026-04-20T00:00:00Z" AND total_calories.interval.start_time < "2026-04-21T00:00:00Z"
Authorization: Bearer access-token
Accept: application/json

活动消耗的能量

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

REST 表示法示例

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

指南

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

  • 每日概览： 如需显示每日卡路里总消耗量，请请求 total-calories 数据类型的每日汇总。
  • 仅活动消耗量： 如需跟踪特定锻炼期间或全天消耗的卡路里数（不包括静息代谢率），请查询 active-energy-burned。
上一页
数据类型索引
下一页
锻炼