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

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

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

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

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

टेबल: Google Health API के कैलोरी डेटा टाइप

डेटा टाइप   dataType   filter पैरामीटर	रिकॉर्ड टाइप	उपलब्ध कार्रवाइयां	दायरा	वेबबुक support	ट्रू ज़ीरो की सुविधा
खर्च की गई ऐक्टिव एनर्जी   active-energy-burned   active_energy_burned	इंटरवल	list, reconcile, rollup, dailyRollup	activity_and_fitness
आराम करते समय खर्च हुई कैलोरी का डेटा   basal-energy-burned   basal_energy_burned	इंटरवल	सूची बनाना, मेल करना	activity_and_fitness
बेसल मेटाबॉलिक रेट   basal-metabolic-rate   basal_metabolic_rate	नमूना	सूची बनाना, मेल करना	पोषण

यहां दिए गए सेक्शन में, हर डेटा टाइप के बारे में तकनीकी जानकारी दी गई है. इसमें 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
}

आराम करते समय खर्च हुई कैलोरी

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

ध्यान दें: इस डेटा टाइप के लिए, रोलअप और रोज़ाना रोलअप करने की सुविधा उपलब्ध नहीं है. हर दिन की बेसल एनर्जी वैल्यू पाने के लिए, बेसल मेटाबॉलिक रेट डेटा टाइप का इस्तेमाल करें.

बेसल मेटाबॉलिक रेट

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

डेवलपर, rateKcalPerDay फ़ील्ड में मौजूद basal-metabolic-rate सैंपल को, बेसल एनर्जी बर्न के रोज़ाना के रोलअप के तौर पर इस्तेमाल कर सकते हैं.

REST के उदाहरण के तौर पर दिखाया गया डेटा

{
  "date": {
    "year": 2026,
    "month": 4,
    "day": 20
  },
  "dataSource": { ... },
  "rateKcalPerDay": 1650.0
}

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

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

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