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 (au repos).

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 dépensée   active-energy-burned   active_energy_burned	Intervalle	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Total de calories   total-calories   total_calories	Intervalle	rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly

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 de calories

"Total de 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.

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 dépensée

"É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
}

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.