Tipos de datos de calorías y energía

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

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

Tipos de datos admitidos

La API admite los siguientes tipos de datos para medir las calorías y el consumo de energía:

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

Tipo de datos   dataType Parámetro   filter	Record type	Operaciones disponibles	Alcance	Compatibilidad con webhook	Compatibilidad con True zeros
Calorías quemadas por actividad   active-energy-burned   active_energy_burned	Intervalo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Energía basal quemada   basal-energy-burned   basal_energy_burned	Intervalo	lista, reconciliar	activity_and_fitness
Tasa metabólica basal   basal-metabolic-rate   basal_metabolic_rate	Muestra	lista, reconciliar	nutrición

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.

Calorías totales

Calorías totales 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, y se mide en kilocalorías (kcal). El valor se calcula a partir del gasto de energía activa y la tasa metabólica basal del usuario.

Energía activa quemada

El gasto calórico activo representa la energía que quemó el usuario durante los períodos de actividad, sin incluir su gasto energético basal, y se mide 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
}

Energía basal quemada

Las calorías quemadas por energía basal representan las calorías quemadas debido al metabolismo en reposo del usuario durante intervalos de tiempo, medidas en kilocalorías (kcal).

Nota: Las operaciones de resumen y resumen diario no están disponibles para este tipo de datos. Para obtener los valores de energía basal diarios, usa el tipo de datos de Tasa metabólica basal.

Tasa metabólica basal

La tasa metabólica basal mide la energía que gasta el cuerpo en un estado normal de reposo y se mide en kilocalorías por día (kcal/day). Debido a que esta tasa fluctúa con las actualizaciones físicas (como el peso) con el tiempo, la API registra la BMR como una serie temporal de muestras de la tasa.

Los desarrolladores pueden tratar el campo rateKcalPerDay en una muestra de basal-metabolic-rate como el equivalente diario de un resumen diario de la energía basal quemada.

Ejemplo de representación de REST

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

Lineamientos

Cuando integres las 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 por actividad: Para hacer un seguimiento de las calorías quemadas durante un entrenamiento específico o a lo largo del día, sin incluir la tasa metabólica en reposo, consulta active-energy-burned.
• Métricas basales: Para hacer un seguimiento de la tasa metabólica en reposo o las tendencias metabólicas basales, consulta basal-metabolic-rate para obtener los valores de la BMR. Trata las muestras de BMR como un valor de referencia diario para el consumo de energía en reposo del usuario.