Google Health API-Datentypen

Die folgende Tabelle enthält die vollständige Liste der Datentypen. In mehreren Spalten wird die Darstellung der einzelnen Typen in der Google Health API sowie der Umfang beschrieben, unter dem sie jeweils verfügbar sind.

**Wichtig**: Das Format der Datentyp-IDs unterscheidet sich, wenn der Datentyp aus mehr als einem Wort besteht. In einem Endpunkt muss der Datentypname im Kebab-Case-Format angegeben werden, z. B. body-fat. In einem Filterparameter muss der Datentypname jedoch im Snake-Case-Format angegeben werden, z. B. body_fat.

Tabelle: Datentypen der Google Health API

Datentyp   dataType   filter Parameter	Datensatztyp	Verfügbare Vorgänge	Umfang	Webhook Unterstützung
Aktive Minuten   active-minutes   active_minutes	Intervall	reconcile, rollup, dailyRollup	activity_and_fitness
Aktivzonenminuten   active-zone-minutes   active_zone_minutes	Intervall	list, reconcile, rollup, dailyRollup	activity_and_fitness
Aktivitätslevel   activity-level   activity_level	Intervall	list, reconcile	activity_and_fitness
Höhe   altitude   altitude	Intervall	list, reconcile, rollup, dailyRollup	activity_and_fitness
Körperfett   body-fat   body_fat	Beispiel	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements
Kalorien in der Herzfrequenzzone   calories-in-heart-rate-zone   calories_in_heart_rate_zone	Intervall	rollup, dailyRollup	activity_and_fitness
Tägliche Herzfrequenzvariabilität   daily-heart-rate-variability   daily_heart_rate_variability	Täglich	list, reconcile	health_metrics_and_measurements
Tägliche Herzfrequenzzonen   daily-heart-rate-zones   daily_heart_rate_zones	Täglich	reconcile	health_metrics_and_measurements
Tägliche Sauerstoffsättigung   daily-oxygen-saturation   daily_oxygen_saturation	Täglich	list, reconcile	health_metrics_and_measurements
Tägliche Atemfrequenz   daily-respiratory-rate   daily_respiratory_rate	Täglich	list, reconcile	health_metrics_and_measurements
Tägliche Ruheherzfrequenz   daily-resting-heart-rate   daily_resting_heart_rate	Täglich	list, reconcile	health_metrics_and_measurements
Tägliche Ableitungen der Schlaftemperatur   daily-sleep-temperature-derivations   daily_sleep_temperature_derivations	Täglich	list, reconcile	health_metrics_and_measurements
Tägliche maximale Sauerstoffaufnahme   daily-vo2-max   daily_vo2_max	Täglich	list, reconcile	activity_and_fitness
Entfernung   distance   distance	Intervall	list, reconcile, rollup, dailyRollup	activity_and_fitness
Training   exercise   exercise	Sitzung	list, get, reconcile, create, update, batchDelete	activity_and_fitness
Etagen   floors   floors	Intervall	reconcile, rollup, dailyRollup	activity_and_fitness
Herzfrequenz   heart-rate   heart_rate	Beispiel	list, reconcile, rollup, dailyRollup	health_metrics_and_measurements
Herzfrequenzvariabilität   heart-rate-variability   heart_rate_variability	Beispiel	list, reconcile	health_metrics_and_measurements
Größe   height   height	Beispiel	list, get, reconcile, create, update, batchDelete	health_metrics_and_measurements
Flüssigkeitszufuhr-Protokoll   hydration-log   hydration_log	Sitzung	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	Ernährung
Sauerstoffsättigung   oxygen-saturation   oxygen_saturation	Beispiel	list, reconcile	health_metrics_and_measurements
Zusammenfassung der Atemfrequenz im Schlaf   respiratory-rate-sleep-summary   respiratory_rate_sleep_summary	Beispiel	list, reconcile	health_metrics_and_measurements
Maximale Sauerstoffaufnahme bei Lauf   run-vo2-max   run_vo2_max	Beispiel	list, reconcile, rollup, dailyRollup	activity_and_fitness
Sitzperiode   sedentary-period   sedentary_period	Intervall	list, reconcile, rollup, dailyRollup	activity_and_fitness
Schlaf   sleep   sleep	Sitzung	list, get, reconcile, create, update, batchDelete	Schlaf
Schritte   steps   steps	Intervall	list, reconcile, rollup, dailyRollup	activity_and_fitness
Daten zu Bahnen   swim-lengths-data   swim_lengths_data	Intervall	list, reconcile, rollup, dailyRollup	activity_and_fitness
Zeit in der Herzfrequenzzone   time-in-heart-rate-zone   time_in_heart_rate_zone	Intervall	reconcile, rollup, dailyRollup	activity_and_fitness
Kalorien insgesamt   total-calories   total_calories	Intervall	rollup, dailyRollup	activity_and_fitness
Maximale Sauerstoffaufnahme   vo2-max   vo2_max	Beispiel	list, reconcile	activity_and_fitness
Gewicht   weight   weight	Beispiel	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements

Datenverfügbarkeit

Aktualisierungen der Nutzerdaten sind erst verfügbar, nachdem der Nutzer seinen Aktivitätstracker synchronisiert oder manuell neue Daten in die Fitbit App oder Web-App eingegeben hat. Das Fitbit-Gerät und die Fitbit App können alle 15 Minuten automatisch synchronisiert werden, wenn die Fitbit App auf dem Mobilgerät geöffnet ist, eine aktive Datenverbindung besteht und sich die beiden Geräte in Bluetooth-Reichweite befinden. Wenn der Nutzer seine Aktivität mit MobileTrack aufzeichnet, wird MobileTrack stündlich synchronisiert, solange die App geöffnet ist.

Zugriff durch Drittanbieter-Apps

Fitbit-Geräte können nicht direkt mit Drittanbieteranwendungen oder ‑diensten kommunizieren. Sie sind so konzipiert, dass sie ausschließlich mit der Fitbit App kommunizieren und synchronisiert werden.

Das Gerät synchronisiert die Daten im Laufe des Tages automatisch, wenn die Fitbit App geöffnet ist, oder alle 15 Minuten, wenn Bluetooth aktiviert ist und die App im Hintergrund ausgeführt wird. Nach Abschluss der Synchronisierung sind die Daten über die Google Health API für Drittanbieterdienste verfügbar.

Entfernungsstandards

Entfernungen bei Trainings, z. B. elevationGainMillimeters, werden aus folgenden Gründen in Millimetern als Standardeinheit gemessen:

1. Datenpräzision: Der wichtigste Grund für die Verwendung von Millimetern ist, dass wir keine Präzision bei den Daten verlieren, die wir lesen und bereitstellen. Mit einer feingliedrigen Einheit wie Millimetern können wir Messungen mit hoher Genauigkeit darstellen.
2. Standardisierung: Millimeter sind die standardisierte Einheit, die für alle unsere Dienste verwendet wird. Diese Konsistenz sorgt für eine einheitliche Nutzererfahrung für Entwickler, die mit verschiedenen Teilen der API interagieren.
3. Breite Unterstützung von Messsystemen: Durch die Verwendung einer Basiseinheit wie Millimetern können Entwickler problemlos in jede andere gewünschte Einheit umrechnen, unabhängig davon, ob sie mit metrischen, imperialen oder anderen Messsystemen arbeiten.