Datentypen für Kalorien und Energie

Die Google Health API bietet Datentypen, mit denen der Kalorienverbrauch und der Energieverbrauch eines Nutzers erfasst werden können. Diese Typen messen verschiedene Aspekte des Energieverbrauchs, einschließlich des Gesamtverbrauchs, des aktiven Verbrauchs und des Grundumsatzes.

Wenn Sie die Unterschiede zwischen diesen Datentypen kennen, können Sie besser entscheiden, welche Messwerte für Ihre Anwendung geeignet sind.

Unterstützte Datentypen

Die API unterstützt die folgenden Datentypen zum Messen des Kalorien- und Energieverbrauchs:

Tabelle: Datentypen für Kalorien in der Google Health API

Datentyp   dataType   filter Parameter	Datensatztyp	Verfügbare Vorgänge	Umfang	Webhook Unterstützung	Unterstützung für echte Nullen
Durch Aktivität verbrauchte Kalorien   active-energy-burned   active_energy_burned	Intervall	list, reconcile, rollup, dailyRollup	activity_and_fitness
Durch Grundumsatz verbrauchte Kalorien   basal-energy-burned   basal_energy_burned	Intervall	list, reconcile	activity_and_fitness
Grundumsatz   basal-metabolic-rate   basal_metabolic_rate	Beispiel	list, reconcile	nutrition

In den folgenden Abschnitten finden Sie technische Details zu den einzelnen Datentypen, einschließlich Beispielen für die REST-Darstellung und spezifischen Einschränkungen bei der Integration.

Gesamtanzahl der Kalorien

„Gesamtanzahl der Kalorien“ ist ein schreibgeschützter abgeleiteter Datentyp, mit dem der gesamte Energieverbrauch eines Nutzers erfasst wird, einschließlich des Grundumsatzes und der aktiven Energie, gemessen in Kilokalorien (kcal). Der Wert wird aus dem aktiven Energieverbrauch und dem Grundumsatz des Nutzers berechnet.

Hinweis:Abfragen für den Datentyp total-calories müssen einen Zeitraumfilter enthalten, z. B. total_calories.interval.start_time oder total_calories.interval.civil_start_time. Der maximale Zeitraum für diese Abfragen beträgt 14 Tage.

Beispielabfrage

Wenn Sie den Datentyp total-calories abfragen möchten, senden Sie eine Anfrage an den Endpunkt list mit einem Intervallfilter:

Anfrage

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

Durch Aktivität verbrauchte Kalorien

„Durch Aktivität verbrauchte Kalorien“ gibt die Energie an, die der Nutzer während der Aktivitätsphasen verbraucht hat, ohne den Grundumsatz, gemessen in Kilokalorien (kcal).

Beispiel für die REST-Darstellung

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

Durch Grundumsatz verbrauchte Kalorien

„Durch Grundumsatz verbrauchte Kalorien“ gibt die Kalorien an, die aufgrund des Grundumsatzes des Nutzers in bestimmten Zeiträumen verbrannt wurden, gemessen in Kilokalorien (kcal).

Hinweis:Die Vorgänge „rollup“ und „dailyRollup“ sind für diesen Datentyp nicht verfügbar. Wenn Sie die täglichen Werte für den Grundumsatz abrufen möchten, verwenden Sie den Datentyp „Grundumsatz“.

Grundumsatz

Der Grundumsatz misst die Energie, die ein Körper in einem normalen Ruhezustand verbraucht, gemessen in Kilokalorien pro Tag (kcal/day). Da dieser Wert im Laufe der Zeit mit körperlichen Veränderungen (z. B. Gewicht) schwankt, erfasst die API den Grundumsatz als Zeitreihe von Ratenbeispielen.

Entwickler können das Feld rateKcalPerDay in einem basal-metabolic-rate-Beispiel als tägliches Gegenstück zu einer täglichen Zusammenfassung des Grundumsatzes betrachten.

Beispiel für die REST-Darstellung

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

Richtlinien

Beachten Sie bei der Einbindung von Kalorien- und Energiemesswerten in Ihre App die folgenden Richtlinien:

• Tagesübersicht:Wenn Sie den gesamten täglichen Kalorienverbrauch anzeigen möchten, fordern Sie die tägliche Zusammenfassung des Datentyps total-calories an.
• Verbrauch nur durch Aktivität:Wenn Sie die Kalorien erfassen möchten, die während eines bestimmten Trainings oder im Laufe des Tages verbrannt wurden, ohne den Grundumsatz, fragen Sie active-energy-burned ab.
• Grundumsatz:Wenn Sie den Grundumsatz oder Trends beim Grundumsatz erfassen möchten, fragen Sie basal-metabolic-rate nach Werten für den Grundumsatz ab. Behandeln Sie Grundumsatz-Beispiele als tägliche Baseline für den Energieverbrauch des Nutzers im Ruhezustand.