Kalori ve enerji veri türleri

Google Health API, kullanıcının kalori ve enerji harcamasını takip eden veri türleri sağlar. Bu türler, toplam harcama, aktif yakma ve dinlenme (bazal) metabolizma hızları dahil olmak üzere enerji yakımının farklı yönlerini ölçer.

Uygulamanıza hangi metriklerin uygun olduğunu belirlemek için bu veri türleri arasındaki farkları anlayın.

Desteklenen veri türleri

API, kalori ve enerji harcamasını ölçmek için aşağıdaki veri türlerini destekler:

Tablo: Google Health API kalori veri türleri

Veri türü   dataType   filter parametresi	Kayıt türü	Kullanılabilir işlemler	Kapsam	Webhook desteği	Gerçek sıfırlar desteği
Yakılan Aktif Enerji   active-energy-burned   active_energy_burned	Aralık	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Toplam Kalori   total-calories   total_calories	Aralık	grup, günlükGrup	.activity_and_fitness.readonly .activity_and_fitness.writeonly

Aşağıdaki bölümlerde, REST gösterimi örnekleri ve belirli entegrasyon kısıtlamaları da dahil olmak üzere her veri türüyle ilgili teknik ayrıntılar verilmektedir.

Toplam Kalori

Toplam Kalori, bazal metabolizma ve aktif enerji dahil olmak üzere bir kullanıcının harcadığı tüm enerjiyi kilokalori (kcal) cinsinden ölçerek izleyen salt okunur bir türetilmiş veri türüdür. Değer, aktif enerji harcaması ve kullanıcının bazal metabolizma hızından hesaplanır.

total-calories veri türü için sorgular bir zaman aralığı filtresi (ör. total_calories.interval.start_time veya total_calories.interval.civil_start_time) içermelidir. Bu sorgular için maksimum aralık 14 gündür.

Sorgu örneği

total-calories veri türünü sorgulamak için list uç noktasına aralık filtresi içeren bir istek gönderin:

İstek

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

Harcanan aktif enerji

Aktif yakılan enerji, kullanıcının bazal enerji harcaması hariç olmak üzere, aktivite dönemlerinde yaktığı enerjiyi temsil eder ve kilokalori (kcal) cinsinden ölçülür.

REST gösterimi örneği

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

Yönergeler

Kalori ve enerji metriklerini uygulamanıza entegre ederken aşağıdaki yönergeleri kullanın:

• Günlük genel bakış: Günlük toplam kalori harcamasını göstermek için total-calories veri türünün günlük toplamını isteyin.
• Yalnızca aktivite harcaması: Belirli bir antrenman sırasında veya gün boyunca yakılan kalorileri dinlenme metabolizma hızı hariç olacak şekilde izlemek için active-energy-burned sorgusunu kullanın.