कैलोरी और ऊर्जा से जुड़े डेटा टाइप

Google Health API, ऐसे डेटा टाइप उपलब्ध कराता है जिनसे उपयोगकर्ता की कैलोरी और खर्च की गई एनर्जी को ट्रैक किया जा सकता है. इन टाइप से, खर्च की गई एनर्जी के अलग-अलग पहलुओं को मापा जाता है. इनमें कुल खर्च की गई एनर्जी, शारीरिक गतिविधि में खर्च की गई एनर्जी, और आराम की स्थिति में कैलोरी खर्च होने की दर (बेसल मेटाबॉलिक रेट) शामिल हैं.

इन डेटा टाइप के बीच के अंतर को समझें, ताकि यह तय किया जा सके कि आपके ऐप्लिकेशन के लिए कौनसी मेट्रिक सही हैं.

डेटा टाइप, जो इस्तेमाल किए जा सकते हैं

एपीआई, कैलोरी और खर्च की गई एनर्जी को मापने के लिए, इन डेटा टाइप का इस्तेमाल करता है:

टेबल: Google Health API के कैलोरी डेटा टाइप
डेटा टाइप
  dataType
  filter पैरामीटर		 रिकॉर्ड
टाइप		 उपलब्ध
ऑपरेशन		 दायरा वेबसाइट
सपोर्ट		 सही ज़ीरो
सपोर्ट
शारीरिक गतिविधि में खर्च हुई कैलोरी का डेटा
  active-energy-burned
  active_energy_burned 		इंटरवल list, reconcile, rollup, dailyRollup activity_and_fitness
कुल कैलोरी
  total-calories
  total_calories 		इंटरवल rollup, dailyRollup activity_and_fitness

इन सेक्शन में, हर डेटा टाइप के लिए तकनीकी जानकारी दी गई है. इनमें REST के उदाहरण और इंटिग्रेशन से जुड़ी खास पाबंदियां शामिल हैं.

कुल कैलोरी

कुल कैलोरी, सिर्फ़ पढ़ने के लिए उपलब्ध, डिराइव किया गया डेटा टाइप है. इससे उपयोगकर्ता की खर्च की गई कुल एनर्जी को ट्रैक किया जाता है. इसमें बेसल मेटाबॉलिज़्म और शारीरिक गतिविधि में खर्च की गई एनर्जी शामिल है. इसे किलोकैलोरी (kcal) में मापा जाता है. इस वैल्यू का हिसाब, शारीरिक गतिविधि में खर्च की गई एनर्जी और उपयोगकर्ता के बेसल मेटाबॉलिक रेट के आधार पर लगाया जाता है.

total-calories डेटा टाइप के लिए क्वेरी में, टाइम इंटरवल फ़िल्टर शामिल होना चाहिए. जैसे, total_calories.interval.start_time या total_calories.interval.civil_start_time. इन क्वेरी के लिए, ज़्यादा से ज़्यादा 14 दिनों की सीमा तय की जा सकती है.

क्वेरी का उदाहरण

total-calories डेटा टाइप के लिए क्वेरी करने के लिए, इंटरवल फ़िल्टर के साथ list एंडपॉइंट पर अनुरोध भेजें:

अनुरोध

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

शारीरिक गतिविधि में खर्च हुई कैलोरी का डेटा

शारीरिक गतिविधि में खर्च हुई कैलोरी का डेटा, उपयोगकर्ता की शारीरिक गतिविधि के दौरान खर्च की गई एनर्जी को दिखाता है. इसमें आराम की स्थिति में कैलोरी खर्च होने की दर (बेसल मेटाबॉलिक रेट) शामिल नहीं है. इसे किलोकैलोरी (kcal) में मापा जाता है.

REST के उदाहरण

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

दिशा-निर्देश

अपने ऐप्लिकेशन में कैलोरी और एनर्जी मेट्रिक को इंटिग्रेट करते समय, इन दिशा-निर्देशों का पालन करें:

  • हर दिन की खास जानकारी: हर दिन खर्च की गई कुल कैलोरी दिखाने के लिए, total-calories डेटा टाइप के लिए, हर दिन के रोलअप का अनुरोध करें.
  • सिर्फ़ शारीरिक गतिविधि में खर्च की गई कैलोरी का डेटा: किसी खास वर्कआउट के दौरान या पूरे दिन में खर्च की गई कैलोरी को ट्रैक करने के लिए, active-energy-burned के लिए क्वेरी करें. इसमें आराम की स्थिति में कैलोरी खर्च होने की दर (बेसल मेटाबॉलिक रेट) शामिल नहीं है.
पीछे जाएं
मेरे डिवाइस पर यह सुविधा काम नहीं करती
आगे बढ़ें
ज़रूरी जानकारी