Google Health API veri türleri

Aşağıdaki tabloda, her türün Google Health API'deki temsilini ve her birinin kullanılabildiği kapsamı anlamanıza yardımcı olacak birkaç sütun içeren tam veri türleri listesi yer almaktadır.

Not: Fitbit Ace cihazları Health API tarafından desteklenmez. Daha fazla bilgi için Çocuk Hesapları İçin Fitbit Gizlilik Politikası'na bakın.

Veri türü alanları

Google Health API veri türleri tablosunda, her veri türünün temsilini ve gereksinimlerini anlamanıza yardımcı olacak birkaç alan sütunu bulunur. Bu sütunlar aşağıdaki gibidir:

Tablo: Google Health API veri türü alanlarının açıklamaları

Alan	Açıklama
dataType	Uç nokta URL'lerinde kullanılan, kısa çizgilerle ayrılmış tanımlayıcı (ör. active-minutes).
filter parametresi	Günlük toplayıcı ve toplayıcı isteklerinde dataType filtre parametresinin değeri olarak kullanılan, alt çizgilerle ayrılmış tanımlayıcı (ör. active_minutes).
Kayıt türü	Kaydedilen verilerin yapısını ve biçimini gösterir. Bu, veri noktalarının kaynak temsiliyle uyumludur. Olası değerler şunlardır: Interval (Belirli bir süre boyunca kaydedilen ölçümleri temsil eder.) Sample (Anlık ölçümleri temsil eder.) Daily (Günlük olarak toplanan veya kaydedilen ölçümleri temsil eder.) Session (Antrenman veya elektrokardiyogram (EKG) seansı gibi sürekli bir kayıt bloğunu temsil eder.) Food (Bir gıda maddesini veya beslenmeyle ilgili veri varlığını temsil eder.)
Kullanılabilir işlemler	Veri türü için desteklenen API yöntemlerini (ör. list, create ve rollUp) listeler.
Kapsam	Veri türüne erişmek için gereken OAuth kapsamları.
Webhook desteği	Veri türünün, yeni veriler senkronize edildiğinde webhook'ları kullanarak gerçek zamanlı bildirimleri desteklediğini gösterir.
Gerçek sıfır desteği	Veri türünün, etkin bir sıfır değeri (ör. sıfır aktif dakika) ile eksik veya kaydedilmemiş verileri ayırt etmek için açık sıfır değerlerinin kaydedilmesini desteklediğini gösterir.
Depolama çözünürlüğü	Veri noktalarının depolandığı minimum kayıt veya örnekleme aralığı (örneğin, steps için 1 dakika). Toplamalar için bu, alt aralık veri yapaylıkları olmadan eşit olarak dağıtılmış toplama sağlamak için önerilen minimum windowSize değerini temsil eder.
Uyumlu cihazlar	Bu veri türünü kaydedip Google Health API ile senkronize edebilen (Fitbit uygulamasını kullanarak) fiziksel cihazların genişletilebilir listesi.

Tablo: Google Health API veri türleri

Veri türü	Kullanılabilir işlemler	Kapsam
Aktif Enerji Tüketimi dataType: active-energy-burned filter parameter: active_energy_burned Kayıt türü: Aralık Depolama çözünürlüğü: 1 dakika Kalori ve enerji rehberi	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Aktif Dakikalar dataType: active-minutes filter parameter: active_minutes Kayıt türü: Aralık Depolama çözünürlüğü: 1 dakika Webhook desteği Uyumlu cihazlar Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire HR Pixel Watch 4	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Aktif Bölge Dakikası dataType: active-zone-minutes filter parameter: active_zone_minutes Kayıt türü: Aralık Depolama çözünürlüğü: 1 dakika Webhook desteği Uyumlu cihazlar Fitbit Air Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Etkinlik düzeyi dataType: activity-level filter parameter: activity_level Kayıt türü: Aralık Webhook desteği	listeleme, mutabakat	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Altitude dataType: altitude filter parameter: altitude Kayıt türü: Aralık Depolama çözünürlüğü: 1 dakika Webhook desteği Gerçek sıfır desteği	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Kan Şekeri dataType: blood-glucose filter parameter: blood_glucose Kayıt türü: Örnek Webhook desteği Önemli Web Verileri kılavuzu	list, get, reconcile, rollup, dailyRollup	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Vücut Yağ Yüzdesi dataType: body-fat filter parameter: body_fat Kayıt türü: Örnek Webhook desteği Uyumlu cihazlar Fitbit Aria Fitbit Aria 2 Fitbit Aria Air	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Nabız Bölgesinde Yakılan Kalori dataType: calories-in-heart-rate-zone filter parameter: calories_in_heart_rate_zone Kayıt türü: Aralık Depolama çözünürlüğü: 1 dakika Webhook desteği	rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Temel Vücut Sıcaklığı dataType: core-body-temperature filter parameter: core_body_temperature Kayıt türü: Örnek Vitals kılavuzu	list, get, reconcile, rollup, dailyRollup	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Günlük Nabız Değişkenliği dataType: daily-heart-rate-variability filter parameter: daily_heart_rate_variability Kayıt türü: Günlük Webhook desteği Yaşam Değerleri kılavuzu Uyku kılavuzu Uyumlu cihazlar Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	listeleme, mutabakat	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Günlük Nabız Bölgeleri dataType: daily-heart-rate-zones filter parameter: daily_heart_rate_zones Kayıt türü: Günlük Webhook desteği Önemli Web Verileri kılavuzu	listeleme, mutabakat	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Günlük Oksijen Doygunluğu dataType: daily-oxygen-saturation filter parameter: daily_oxygen_saturation Kayıt türü: Günlük Webhook desteği Yaşam Değerleri kılavuzu Uyku kılavuzu Uyumlu cihazlar Fitbit Air Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 3 Fitbit Ionic Fitbit Luxe Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	listeleme, mutabakat	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Günlük Solunum Hızı dataType: daily-respiratory-rate filter parameter: daily_respiratory_rate Kayıt türü: Günlük Webhook desteği Yaşam Değerleri kılavuzu Uyku kılavuzu Uyumlu cihazlar Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	listeleme, mutabakat	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Günlük Dinlenme Nabzı dataType: daily-resting-heart-rate filter parameter: daily_resting_heart_rate Kayıt türü: Günlük Webhook desteği Önemli Web Verileri kılavuzu Uyumlu cihazlar Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	listeleme, mutabakat	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Günlük Uyku Sıcaklığı Değişimleri dataType: daily-sleep-temperature-derivations filter parameter: daily_sleep_temperature_derivations Kayıt türü: Günlük Webhook desteği Hayati bulgular kılavuzu Uyku kılavuzu Deri sıcaklığı kılavuzu Uyumlu cihazlar Fitbit Air Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	listeleme, mutabakat	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Günlük Maksimum Oksijen Tüketimi dataType: daily-vo2-max filter parameter: daily_vo2_max Kayıt türü: Günlük Uyumlu cihazlar Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	listeleme, mutabakat	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Mesafe dataType: distance filter parameter: distance Kayıt türü: Aralık Depolama çözünürlüğü: 1 dakika Webhook desteği Gerçek sıfır desteği Uyumlu cihazlar Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Fitbit MobileTrack Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Elektrokardiyogram (EKG) dataType: electrocardiogram filter parameter: electrocardiogram Kayıt türü: Oturum Vitals kılavuzu Uyumlu cihazlar Fitbit Charge 5 Fitbit Charge 6 Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2	list	.ecg.readonly
Egzersiz dataType: exercise filter parameter: exercise Kayıt türü: Oturum Webhook desteği Antrenmanlar kılavuzu Uyumlu cihazlar Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Fitbit MobileTrack Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, get, reconcile, create, update, batchDelete	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Katlar dataType: floors filter parameter: floors Kayıt türü: Aralık Depolama çözünürlüğü: 1 dakika Webhook desteği Gerçek sıfır desteği	reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Yiyecek dataType: food filter parameter: food Kayıt türü: Yiyecek Beslenme rehberi	list, get	.nutrition.readonly .nutrition.writeonly
Yiyecek Ölçü Birimi dataType: food-measurement-unit filter parameter: food_measurement_unit Kayıt türü: Yiyecek Beslenme rehberi Uyumlu cihazlar Fitbit Air Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Ionic Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	list, get	.nutrition.readonly .nutrition.writeonly
Nabız dataType: heart-rate filter parameter: heart_rate Kayıt türü: Örnek Depolama çözünürlüğü: 1 saniye Webhook desteği Önemli Web Verileri kılavuzu Uyumlu cihazlar Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Nabız Değişkenliği dataType: heart-rate-variability filter parameter: heart_rate_variability Kayıt türü: Örnek Webhook desteği Yaşam değerleri kılavuzu Uyku kılavuzu Uyumlu cihazlar Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Fitbit MobileTrack Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	listeleme, mutabakat	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Boy dataType: height filter parameter: height Kayıt türü: Örnek Webhook desteği	list, get, reconcile, create, update, batchDelete	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Sıvı Alımı Günlüğü dataType: hydration-log filter parameter: hydration_log Kayıt türü: Oturum Webhook desteği	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	.nutrition.readonly .nutrition.writeonly
Düzensiz Kalp Ritmi Bildirimi dataType: irregular-rhythm-notification filter parameter: irregular_rhythm_notification Kayıt türü: Oturum Vitals kılavuzu	list	.irn.readonly
Menstrüasyon Dönemi dataType: menstrual-period filter parameter: menstrual_period Kayıt türü: Aralık Kadın Sağlığı kılavuzu	create, update, batchDelete	.reproductive_health.writeonly
Modlar dataType: moods filter parameter: moods Kayıt türü: Örnek Kadın Sağlığı kılavuzu	create, update, batchDelete	.mindfulness.writeonly
Beslenme Günlüğü dataType: nutrition-log filter parameter: nutrition_log Kayıt türü: Oturum Webhook desteği Beslenme rehberi Uyumlu cihazlar Fitbit Air Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	.nutrition.readonly .nutrition.writeonly
Ovülasyon Testi dataType: ovulation-test filter parameter: ovulation_test Kayıt türü: Örnek Kadın Sağlığı kılavuzu	create, update, batchDelete	.reproductive_health.writeonly
Oksijen Doygunluğu dataType: oxygen-saturation filter parameter: oxygen_saturation Kayıt türü: Örnek Depolama çözünürlüğü: 1 dakika Vitals rehberi Uyku rehberi Uyumlu cihazlar Fitbit Air Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 3 Fitbit Ionic Fitbit Luxe Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	listeleme, mutabakat	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Solunum Hızı Uyku Özeti dataType: respiratory-rate-sleep-summary filter parameter: respiratory_rate_sleep_summary Kayıt türü: Örnek Webhook desteği Yaşam Değerleri kılavuzu Uyku kılavuzu Uyumlu cihazlar Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	listeleme, mutabakat	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Maksimum oksijen tüketimi koşusu dataType: run-vo2-max filter parameter: run_vo2_max Kayıt türü: Örnek Webhook desteği Uyumlu cihazlar Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Hareketsiz Dönem dataType: sedentary-period filter parameter: sedentary_period Kayıt türü: Aralık Webhook desteği Uyumlu cihazlar Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Fitbit MobileTrack Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Deri Sıcaklığı Sensörleri v4beta dataType: skin-temperature-sensors filter parameter: skin_temperature_sensors Kayıt türü: Örnek Hayati bulgular kılavuzu Deri Sıcaklığı kılavuzu Kadın Sağlığı kılavuzu Uyumlu cihazlar Pixel Watch 4 Pixel Watch 5	list	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Uyku dataType: sleep filter parameter: sleep Kayıt türü: Oturum Webhook desteği Uyku rehberi Uyumlu cihazlar Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, get, reconcile, create, update, batchDelete	.sleep.readonly .sleep.writeonly
Adımlar dataType: steps filter parameter: steps Kayıt türü: Aralık Depolama çözünürlüğü: 1 dakika Webhook desteği Gerçek sıfır desteği Adım adım kılavuz Uyumlu cihazlar Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Fitbit MobileTrack Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Yüzme Mesafesi Verileri dataType: swim-lengths-data filter parameter: swim_lengths_data Kayıt türü: Aralık Uyumlu cihazlar Fitbit Air Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Belirtiler dataType: symptoms filter parameter: symptoms Kayıt türü: Örnek Kadın Sağlığı kılavuzu	create, update, batchDelete	.logged_symptoms.writeonly
Nabız Bölgesinde Geçirilen Süre dataType: time-in-heart-rate-zone filter parameter: time_in_heart_rate_zone Kayıt türü: Aralık Depolama çözünürlüğü: 1 dakika Webhook desteği	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Toplam Kalori dataType: total-calories filter parameter: total_calories Kayıt türü: Aralık Depolama çözünürlüğü: 1 dakika Gerçek sıfır desteği Kalori ve enerji kılavuzu Uyumlu cihazlar Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Fitbit MobileTrack Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Maksimum oksijen tüketimi dataType: vo2-max filter parameter: vo2_max Kayıt türü: Örnek Uyumlu cihazlar Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Ionic Fitbit Luxe Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	listeleme, mutabakat	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Ağırlık dataType: weight filter parameter: weight Kayıt türü: Örnek Webhook desteği Uyumlu cihazlar Fitbit Aria Fitbit Aria 2 Fitbit Aria Air	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly

Sorgu kısıtlamaları

API'den veri noktalarını, toplamaları veya günlük toplamaları sorgularken aşağıdaki kısıtlamaları göz önünde bulundurun:

• Filtre şartları: total-calories gibi salt okunur türetilmiş veri türleri, aralık başlangıç zamanını belirten bir filtre gerektirir (fiziksel veya sivil zaman kullanılarak).
• Sorgu aralığı sınırları: Toplama ve günlük toplama birleştirme uç noktaları, veri türüne göre maksimum sorgu aralığı sınırları uygular:
  • calories-in-heart-rate-zone, heart-rate, active-minutes ve total-calories için maksimum 14 günlük sorgu aralığı.
  • Diğer tüm veri türleri için maksimum 90 günlük sorgu aralığı.
• Toplama penceresi boyutu: rollUp uç noktası çağrılırken windowSize süresi en az 1 saniye ("1s") olmalıdır. Bir saniyeden kısa süreler INVALID_ARGUMENT ile reddedilir. Ayrıca, alt aralıklar arasında eşit olmayan dağılımı önlemek için veri türünün temel depolama çözünürlüğüne eşit veya ondan daha büyük bir windowSize seçin (ör. steps ve distance gibi 1 dakikalık aralık veri türleri için "60s"). Ayrıntılı bilgi için Toplama penceresi ve depolama çözünürlüğü başlıklı makaleyi inceleyin.

Günlük ve aralık veri türleri

Google Health API, nabız değişkenliği (HRV) veya oksijen doygunluğu (SpO2) gibi belirli fizyolojik metrikler için iki farklı veri türü sunar: Günlük sürüm ve Aralık sürümü. Kullanım alanınız için doğru metriği seçmek amacıyla bu farkı anlamak önemlidir:

• Günlük: Tüm gün için önceden toplanmış tek bir özet. İşleme maliyetinden tasarruf etmek için bu seçeneği üst düzey trendler ve günlük gösterge tabloları için kullanın.

• Aralık: Gün boyunca yapılan ayrıntılı, yüksek çözünürlüklü ölçümler. Bu seçeneği, gün içindeki dalgalanmaları grafik üzerinde göstermek veya saatlik ayrıntılı analizler yapmak için kullanın.

Veri kullanılabilirliği

Kullanıcı verileri yalnızca kullanıcı aktivite izleyicisini senkronize ettikten veya Google Health uygulamasına manuel olarak yeni veri girdikten sonra güncellenir. Google Health uygulaması mobil cihazda açıkken, iki cihaz arasında etkin bir veri bağlantısı varken ve cihazlar Bluetooth kapsama alanındayken Fitbit cihazı ile Google Health uygulaması her 15 dakikada bir otomatik olarak senkronize edilebilir. Kullanıcı, MobileTrack'i kullanarak aktiviteyi izliyorsa MobileTrack, uygulama açık olduğu sürece her saat senkronize edilir.

Geçmiş verileri sorgulama

Google Health API'nin temel avantajlarından biri, kullanıcının performansını ve sağlık verilerini uzun süre boyunca takip edebilmesidir. Bir kullanıcının verilerini, kaydedildiği tarihe kadar sorgulayabilirsiniz. API, uygulamanızın kullanabileceği geçmiş verilerin miktarı konusunda herhangi bir sınırlama veya kısıtlama getirmez.

Ancak geçmiş verileri sorgulama işlemi, standart sıklık sınırlarına tabidir. Google Health API, sistem kararlılığını yönetmek ve aşırı yükleri önlemek için uç noktaya özel sayfa boyutlarıyla otomatik sayfalama kullanır. Aşağıdaki sınırlara ve davranışlara dikkat edin:

• Otomatik sayfalama: Uzun bir veri aralığını sorgularsanız API, yalnızca ilgili uç noktanın sayfa boyutu sınırına kadar olan ilk sonuç sayfasını ve nextPageToken değerini döndürür. Sonraki sayfaları istemek için nextPageToken kullanmanız gerekir.
• Değişken sayfa boyutları: Sınırlar, uç noktaya ve veri türüne bağlıdır. Çoğu veri türü için sayfa boyutları en fazla 10.000 ile sınırlıdır. Ancak exercise ve sleep gibi belirli veri türleri için varsayılan ve maksimum sayfa boyutu 25 ile sınırlıdır. Örneğin, bir istemci son 10 yıla ait tüm uyku verilerini isterse API, ilk sayfada yalnızca 25 uyku seansı döndürür.
• Toplama tarih aralığı kısıtlamaları: Veri toplama ve birleştirme uç noktaları (ör. rollUp ve dailyRollUp) için sorgu tarih aralıkları, veri türüne göre kısıtlanır:
  • calories-in-heart-rate-zone, heart-rate, active-minutes ve total-calories için maksimum 14 günlük bir aralık.
  • Diğer tüm toplayıcı veri türleri için maksimum 90 günlük bir aralık.

Uygulamanızın ihtiyaç duyduğu geçmiş verilerin hacmine bağlı olarak, tüm veri kümesini almak için sayfalar arasında sırayla gezinmeniz gerekir. Uygulamanızın veri senkronizasyonu sürecini tasarlarken bunu göz önünde bulundurun.

En iyi performansı elde etmek ve API hatalarını önlemek için geçmiş verileri sorgularken aşağıdaki yönergeleri uygulayın:

Aşamalı veri senkronizasyonu (sıcak yükleme ve sıfırdan yükleme)

• İlk "etkin" yükleme: Birincil yükleme sırası sırasında yalnızca en son 7-14 günlük verileri getirip oluşturun. Bu sayede kullanıcılar, uzun süren sorguları beklemeden verileri hemen görür.
• Arka planda "soğuk" yükleme: Birincil kullanıcı arayüzü oluşturulduktan sonra daha eski geçmiş verilerin alınmasını eşzamansız, daha düşük öncelikli bir sıraya veya arka plan işlemine devredin.

Toplama için sorgu parçalama

• Toplama ve günlük toplama uç noktaları maksimum tarih aralığı sınırı (veri türüne bağlı olarak 14 veya 90 gün) uyguladığından, büyük geçmiş toplama sorgularını bu sınırlar dahilinde daha küçük, sıralı aralıklara bölmeniz gerekir.
• Eşzamanlılık sınırlarına uymak ve kullanıcı arayüzü ilerleme göstergelerinin istikrarlı bir şekilde çalışmasını sağlamak için bu alt sorguları güvenli bir şekilde gruplandırın veya sıralayın.

Önceden toplanmış toplayıcıları kullanma

Genel bakış kontrol panellerini ve trend grafiklerini, önceden toplanmış özet uç noktaları (ör. DailyRollUpDataPoints) kullanacak şekilde yeniden yapılandırın. Bu sayede, arka uçtaki işlem yükü ve istemciye ağ aktarım süresi önemli ölçüde azalır.

Esnek hata işleme (akıllı yeniden denemeler)

• Sıklık sınırlamaları (429 Too Many Requests) ve sunucu ağ geçidi zaman aşımları (504 Gateway Timeout) ile karşılaşıldığında katı eksponansiyel geri yükleme işleme uygulayın. Başarısız olan büyük yükleri hiçbir zaman hemen yeniden denemeyin. Anında yeniden denemeler, arka uçtaki yoğunluğu artırır ve sistemin daha da kötüleşmesine neden olur.

Uyarı: Bu kurallara uyulmaması, beklenmedik davranışlara ve hatalara neden olabilir.

Üçüncü taraf erişimi

Fitbit cihazları, üçüncü taraf uygulamaları veya hizmetleriyle doğrudan iletişim kuramaz. Bu cihazlar, yalnızca Google Health uygulamasıyla iletişim kuracak ve senkronize edilecek şekilde tasarlanmıştır.

Cihaz, gün boyunca Google Health uygulaması açıkken veya Bluetooth etkinse ve uygulama arka planda çalışıyorsa her 15 dakikada bir verileri otomatik olarak senkronize eder. Bu senkronizasyon işlemi tamamlandıktan sonra veriler, Google Health API aracılığıyla üçüncü taraf hizmetleri tarafından kullanılabilir.

Veri kalitesi ve geçerlilik filtreleme

Google Health API, özel istemci tarafı gürültü filtreleme gerektirmeden güvenilir sağlık metrikleri sağlamak için sensör telemetrisini doğrular ve yanıtları döndürmeden önce geçersiz ölçümleri hariç tutar:

• Dakika düzeyinde kan oksijen doygunluğu (oxygen-saturation) için API, yalnızca doğrulanmış ölçümleri döndürür ve kol hareketi, bilekliğin gevşek olması veya sensör güven puanının %50'nin altında olması nedeniyle geçersiz olarak işaretlenen dakikaların yanı sıra geçersiz bir ölçümden önceki ve sonraki 3 dakikayı ve 4 dakikadan kısa olan izole geçerli aralıkları kaldırır. Bu nedenle, dakika düzeyindeki kapsam seyrek olabilir ve boşluklar beklenebilir. Ayrıntılar için Dakika düzeyinde SpO2 filtreleme ve veri geçerliliği başlıklı makaleyi inceleyin.

Mesafe standartları

elevationGainMillimeters gibi egzersiz mesafeleri, aşağıdaki nedenlerden dolayı standart birim olarak milimetre cinsinden ölçülür:

1. Veri hassasiyetini koruma: Milimetre kullanmanın en önemli nedeni, okuduğumuz ve sağladığımız verilerde hassasiyeti kaybetmemektir. Milimetre gibi ayrıntılı bir birim kullanmak, ölçümleri yüksek doğrulukla temsil etmemizi sağlar.
2. Standardizasyon: Milimetre, hizmetlerimiz genelinde tasarlanmış standart birimdir. Bu tutarlılık, API'nin farklı bölümleriyle etkileşim kuran geliştiricilere tek tip bir deneyim sunulmasına yardımcı olur.
3. Geniş Ölçüm Sistemi Desteği: Milimetre gibi bir taban birim kullanmak, geliştiricilerin metrik, İngiliz ölçü birimi veya diğer ölçüm sistemleriyle çalışıp çalışmadıklarına bakılmaksızın seçilen diğer birimlere dönüştürmelerini kolaylaştırır.

Değişken gün uzunlukları

Health API'nin zamanı işleme şekli, yaz saati uygulaması veya seyahat nedeniyle değişen gün uzunluklarını hesaba katmak için kullanıcının zamanına öncelik verir. Her veri noktası, hem fiziksel bir UTC zaman damgası hem de etkinliğin gerçekleştiği sırada geçerli olan UTC farkı ile depolanır. Bu sayede sistem şunları yapabilir:

• Etkinliği tam bir fiziksel ana eşleyin.
• Zamanı, kullanıcının Local Context'ine göre düzeltir.

Yaz Saati

Yaz saati uygulaması sona erdiğinde saatler bir saat geri alınır ve sivil gün 25 saat olur. Bu tarihin toplayıcısı 25 saatlik veri içerir. "İleri saat uygulaması", saatin standart saate geri alındığı 23 saatlik bir sivil günle sonuçlanır.

Seyahat

Farklı saat dilimleri arasında seyahat etmek, tek bir sivil günün fiziksel süresinde daha da önemli değişikliklere neden olabilir.

Saat dilimi farklılıklarını gidermek için dailyRollUp uç noktasını kullanın. Verileri, kullanıcının yerel saatine göre kaydedildiği takvim gününe otomatik olarak atar ve saat dilimi değişikliklerine rağmen günü etkili bir şekilde "birleştirir". Ayrıntılar ve örnekler için Birleştirilmiş veri kılavuzundaki Takvim günleri arasında birleştirme bölümüne bakın.