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. Mit diesen Typen werden verschiedene Aspekte des Energieverbrauchs gemessen, darunter der Gesamtverbrauch, der Verbrauch bei Aktivität und der Grundumsatz.

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.readonly .activity_and_fitness.writeonly
Kalorien insgesamt   total-calories   total_calories	Intervall	rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly

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.

Kalorien insgesamt

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

Abfragen für den Datentyp total-calories müssen einen Zeitintervallfilter 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 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
}

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