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

L'API Google Health fournit des types de données qui suivent les dépenses caloriques et énergétiques d'un utilisateur. Ces types de données 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 (au repos).

Comprendre les différences entre ces types de données vous aidera à 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 les dépenses énergétiques :

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

Type de données   dataType Paramètre   filter	Type Record	Opérations disponibles	Champ d'application	Compatibilité avec les webhooks	Prise en charge des vrais zéros
Énergie active dépensé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 informations 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 Calories" est un type de données dérivées 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.

Remarque : Les requêtes pour le type de données total-calories doivent inclure un filtre d'intervalle de temps (tel que total_calories.interval.start_time ou total_calories.interval.civil_start_time). La plage maximale pour ces requêtes est de 14 jours.

Exemple de requête

Pour interroger le type de données total-calories, envoyez une requête au point de terminaison list avec un filtre d'intervalle :

Requête

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

Énergie active brûlée

L'énergie active brûlé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 de base, 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

L'énergie basale dépensée représente les calories brûlées en raison du métabolisme au repos de l'utilisateur sur des intervalles de temps, mesurées en kilocalories (kcal).

Remarque : Les opérations de consolidation et de consolidation quotidienne 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 "Taux métabolique de base".

Métabolisme de base

Le métabolisme de base mesure l'énergie dépensée par un corps dans un état de repos normal, 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 la forme d'une série temporelle d'échantillons de taux.

Les développeurs peuvent traiter le champ rateKcalPerDay d'un échantillon basal-metabolic-rate comme l'équivalent quotidien d'un cumul quotidien de l'énergie basale dépensé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 sur les calories et l'é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 taux métabolique de repos, interrogez active-energy-burned.
• Métriques de base : pour suivre le taux métabolique de base ou les tendances métaboliques 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.