Types de données "Calories" et "Énergie"

L'API Google Health fournit des types de données qui suivent les calories et la dépense énergétique d'un utilisateur. Ces types mesurent différents aspects de la dépense énergétique, y compris la dépense totale, la dépense active et le métabolisme de base.

Comprenez les différences entre ces types de données pour déterminer les métriques qui conviennent à votre application.

Types de données acceptés

L'API accepte les types de données suivants pour mesurer les calories et la dépense énergétique :

Tableau : Types de données de calories de l'API Google Health

Type de données   dataType   filter paramètre	Type d'enregistrement	Opérations disponibles	Champ d'application	Compatibilité avec les Webhooks	Compatibilité avec les vrais zéros
Énergie active brûlée   active-energy-burned   active_energy_burned	Intervalle	list, reconcile, rollup, dailyRollup	activity_and_fitness
Énergie basale brûlée   basal-energy-burned   basal_energy_burned	Intervalle	list, reconcile	activity_and_fitness
Métabolisme de base   basal-metabolic-rate   basal_metabolic_rate	Échantillon	list, reconcile	nutrition

Les sections suivantes fournissent des détails techniques pour chaque type de données, y compris des exemples de représentation REST et des contraintes d'intégration spécifiques.

Total des calories

"Total des calories" est un type de données dérivé en lecture seule qui suit toute l'énergie dépensée par un utilisateur, y compris le métabolisme de base et l'énergie active, mesurée en kilocalories (kcal). La valeur est calculée à partir de la dépense énergétique active et du métabolisme de base de l'utilisateur.

Énergie active brûlée

L'énergie active dépensée représente l'énergie dépensée par l'utilisateur pendant les périodes d'activité, à l'exclusion de sa dépense énergétique basale, mesurée en kilocalories (kcal).

Exemple de représentation REST

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

Énergie basale brûlée

"Énergie basale brûlée" représente les calories brûlées en raison du métabolisme de base de l'utilisateur sur des intervalles de temps, mesurées en kilocalories (kcal).

Remarque : Les opérations de cumul et de cumul quotidien ne sont pas disponibles pour ce type de données. Pour obtenir les valeurs quotidiennes de l'énergie basale, utilisez le type de données "Métabolisme de base".

Métabolisme de base

"Métabolisme de base" mesure l'énergie dépensée par un corps dans un état de repos normal, mesurée en kilocalories par jour (kcal/day). Étant donné que ce taux fluctue avec les changements physiques (comme le poids) au fil du temps, l'API enregistre le métabolisme de base sous forme de série temporelle d'échantillons de taux.

Les développeurs peuvent traiter le champ rateKcalPerDay dans un échantillon basal-metabolic-rate comme l'équivalent quotidien d'un cumul quotidien de l'énergie basale brûlée.

Exemple de représentation REST

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

Consignes

Lorsque vous intégrez des métriques de calories et d'énergie dans votre application, suivez ces consignes :

• Aperçu quotidien : pour afficher la dépense calorique quotidienne globale, demandez le cumul quotidien du type de données total-calories.
• Dépense uniquement liée à l'activité : pour suivre les calories brûlées pendant un entraînement spécifique ou tout au long de la journée, à l'exclusion du métabolisme de base, interrogez active-energy-burned.
• Métriques basales : pour suivre le métabolisme de base ou les tendances du métabolisme de base, interrogez basal-metabolic-rate pour obtenir les valeurs du métabolisme de base. Traitez les échantillons de métabolisme de base comme une référence quotidienne pour la consommation d'énergie au repos de l'utilisateur.