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
Energía basal quemada   basal-energy-burned   basal_energy_burned	Intervalo	list, reconcile	activity_and_fitness
Tasa metabólica basal   basal-metabolic-rate   basal_metabolic_rate	Muestra	list, reconcile	nutrition

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, 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.

Nota: 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
}

Energía basal quemada

Energía basal quemada representa las calorías quemadas debido al metabolismo en reposo del usuario durante intervalos de tiempo, medidas en kilocalorías (kcal).

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

Tasa metabólica basal

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

Los desarrolladores pueden tratar el campo rateKcalPerDay en una muestra de basal-metabolic-rate como la contraparte diaria de una acumulación diaria de energía basal quemada.

Ejemplo de representación de REST

{
  "date": {
    "year": 2026,
    "month": 4,
    "day": 20
  },
  "dataSource": { ... },
  "rateKcalPerDay": 1650.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 la acumulación diaria 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.
• 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 valores de BMR. Trata las muestras de BMR como un modelo de referencia diario para el consumo de energía en reposo del usuario.