Tipos de datos de calorías y energía

La API de Google Health proporciona tipos de datos que hacen un seguimiento de las calorías y el gasto energético de un usuario. Estos tipos miden diferentes aspectos del gasto calórico, incluido el gasto total, el gasto activo y las tasas metabólicas en reposo (basales).

Comprende las diferencias entre estos tipos de datos para determinar qué métricas se adaptan a tu aplicación.

Tipos de datos admitidos

La API admite los siguientes tipos de datos para medir las calorías y el gasto energético:

Tabla: Tipos de datos de calorías de la API de Google Health

Tipo de datos   dataType   filter parámetro	Tipo de registro	Operaciones disponibles	Alcance	Compatibilidad con webhook	Compatibilidad con ceros verdaderos
Energía activa quemada   active-energy-burned   active_energy_burned	Intervalo	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Total de calorías   total-calories   total_calories	Intervalo	rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly

En las siguientes secciones, se proporcionan detalles técnicos para cada tipo de datos, incluidos ejemplos de representación de REST y restricciones de integración específicas.

Total de calorías

Total de calorías es un tipo de datos derivados de solo lectura que hace un seguimiento de toda la energía que gasta un usuario, incluido el metabolismo basal y la energía activa, medida en kilocalorías (kcal). El valor se calcula a partir del gasto de energía activa y la tasa metabólica basal del usuario.

Las consultas para el tipo de datos total-calories deben incluir un filtro de intervalo de tiempo (como total_calories.interval.start_time o total_calories.interval.civil_start_time). El rango máximo para estas consultas es de 14 días.

Ejemplo de consulta

Para consultar el tipo de datos total-calories, envía una solicitud al extremo list con un filtro de intervalo:

Solicitud

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

Energía activa quemada

El gasto calórico activo representa la energía que quema el usuario durante los períodos de actividad, excluido su gasto energético basal, medido en kilocalorías (kcal).

Ejemplo de representación de REST

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

Lineamientos

Cuando integres métricas de calorías y energía en tu app, usa estos lineamientos:

• Resumen diario: Para mostrar el gasto calórico diario general, solicita el resumen diario del tipo de datos total-calories.
• Gasto solo de actividad: Para hacer un seguimiento de las calorías quemadas durante un entrenamiento específico o durante todo el día, sin incluir la tasa metabólica en reposo, consulta active-energy-burned.