Google Health API की मदद से, वाइटल और सेहत से जुड़ी मेट्रिक के अनुभव डेवलप करना

Google Health API, उपयोगकर्ता की अहम जानकारी और शारीरिक स्वास्थ्य से जुड़ी मेट्रिक को ट्रैक करता है. जैसे, धड़कन की दर, ऑक्सीजन सैचुरेशन, ब्लड ग्लूकोज़, शरीर का तापमान, और नींद के दौरान शरीर के तापमान में रोज़ाना होने वाले बदलाव.

अपने ऐप्लिकेशन में, वाइटल्स डेटा को पढ़ने और उसके लिए उपयोगकर्ता की अनुमति का अनुरोध करने का तरीका जानें. इससे उपयोगकर्ताओं को बेहतर अनुभव दिया जा सकेगा.

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

एपीआई, सेहत से जुड़े डेटा और अहम स्वास्थ्य मेट्रिक को ट्रैक करने के लिए, इन डेटा टाइप के साथ काम करता है:

टेबल: Google Health API के वाइटल डेटा टाइप
डेटा टाइप
  dataType
  filter पैरामीटर		 उपलब्ध
कार्रवाइयां		 दायरा
ब्लड ग्लूकोज़
list, get, reconcile, rollup, dailyRollup .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
शरीर का अंदरूनी तापमान
core-body-temperature
core_body_temperature
रिकॉर्ड टाइप: सैंपल
 list, get, reconcile, rollup, dailyRollup .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
धड़कन की दर में रोज़ाना होने वाला उतार-चढ़ाव
daily-heart-rate-variability
daily_heart_rate_variability
रिकॉर्ड टाइप: हर दिन

संगत डिवाइस
सूची बनाना, मेल करना .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
धड़कन की दर वाले ज़ोन की रोज़ की जानकारी
सूची बनाना, मेल करना .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
रोज़ाना ऑक्सीजन की मात्रा
daily-oxygen-saturation
daily_oxygen_saturation
रिकॉर्ड टाइप: हर दिन

संगत डिवाइस
सूची बनाना, मेल करना .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
रोज़ाना की सांस लेने की दर
daily-respiratory-rate
daily_respiratory_rate
रिकॉर्ड टाइप: हर दिन

संगत डिवाइस
सूची बनाना, मेल करना .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
आराम करते समय धड़कन की रोज़ की दर
daily-resting-heart-rate
daily_resting_heart_rate
रिकॉर्ड टाइप: हर दिन

संगत डिवाइस
सूची बनाना, मेल करना .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
नींद के दौरान शरीर के तापमान में रोज़ाना होने वाले बदलाव
daily-sleep-temperature-derivations
daily_sleep_temperature_derivations
रिकॉर्ड टाइप: हर दिन

संगत डिवाइस
सूची बनाना, मेल करना .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
इलेक्ट्रोकार्डियोग्राम (ईसीजी)
electrocardiogram
electrocardiogram
रिकॉर्ड टाइप: सेशन

संगत डिवाइस
सूची .ecg.readonly
धड़कन की दर
heart-rate
heart_rate
रिकॉर्ड टाइप: सैंपल

संगत डिवाइस
list, reconcile, rollup, dailyRollup .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
धड़कन की दर में उतार-चढ़ाव
heart-rate-variability
heart_rate_variability
रिकॉर्ड टाइप: सैंपल

संगत डिवाइस
सूची बनाना, मेल करना .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
दिल की धड़कन अनियमित होने पर मिलने वाली सूचनाएं
irregular-rhythm-notification
irregular_rhythm_notification
रिकॉर्ड टाइप: सेशन
 सूची .irn.readonly
ऑक्सीजन की मात्रा
oxygen-saturation
oxygen_saturation
रिकॉर्ड टाइप: सैंपल

संगत डिवाइस
सूची बनाना, मेल करना .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
नींद के दौरान सांस लेने की दर की खास जानकारी
respiratory-rate-sleep-summary
respiratory_rate_sleep_summary
रिकॉर्ड टाइप: सैंपल

संगत डिवाइस
सूची बनाना, मेल करना .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly

रीड-ओनली ऐक्सेस की ज़रूरी शर्तें

शारीरिक गतिविधियों से जुड़े डेटा टाइप, डिवाइस सिंक करने या Fitbit के मोबाइल या वेब ऐप्लिकेशन में मैन्युअल तरीके से लॉग की गई एंट्री से भरे जाते हैं. इन्हें REST API के ज़रिए सिर्फ़ पढ़ा जा सकता है. इन्हें Google Health API के एंडपॉइंट के ज़रिए सीधे तौर पर लिखा या बदला नहीं जा सकता.

यहां दिए गए सेक्शन में, परफ़ॉर्मेंस से जुड़े अहम डेटा के लिए तकनीकी जानकारी और REST फ़ॉर्मैट के बारे में बताया गया है.

धड़कन की दर और दिल की सेहत

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

  • धड़कन की दर (heart-rate): किसी समय पर धड़कन की दर की मेज़रमेंट में beatsPerMinute की संख्या के साथ-साथ, उपयोगकर्ता की motionContext (जैसे कि SEDENTARY या ACTIVE) और sensorLocation (जैसे कि WRIST या CHEST) शामिल होती है.
  • आराम करते समय रोज़ाना की धड़कन की दर (daily-resting-heart-rate): आराम करते समय रोज़ाना की धड़कन की दर की बेसलाइन वैल्यू.
  • धड़कन की दर में उतार-चढ़ाव (heart-rate-variability और daily-heart-rate-variability): यह एचआरवी को दिखाने के लिए, मिलीसेकंड में लगातार अंतर (rmssd) के रूट मीन स्क्वेयर को रिकॉर्ड करता है.

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

धड़कन की दर के मेज़रमेंट के बारे में क्वेरी करने के लिए, list एंडपॉइंट पर GET अनुरोध भेजें.

का इस्तेमाल करें

यहां दिए गए उदाहरण में, दिखाई गई सूची से एक heart-rate डेटा पॉइंट दिखाया गया है:

अनुरोध

GET https://health.googleapis.com/v4/users/me/dataTypes/heart-rate/dataPoints?startTime=2026-04-20T08:00:00Z&endTime=2026-04-20T08:05:00Z
Authorization: Bearer access-token
Accept: application/json

जवाब

{
  "dataPoints": [
    {
      "name": "users/me/dataTypes/heart-rate/dataPoints/hr-123456789",
      "dataSource": {
        "recordingMethod": "ACTIVELY_MEASURED"
      },
      "heartRate": {
        "sampleTime": {
          "physicalTime": "2026-04-20T08:00:00Z",
          "utcOffset": "0s"
        },
        "beatsPerMinute": "72",
        "metadata": {
          "motionContext": "SEDENTARY",
          "sensorLocation": "WRIST"
        }
      }
    }
  ]
}

ब्लड ग्लूकोज़

blood-glucose डेटा टाइप, उपयोगकर्ता के ब्लड शुगर लेवल को दिखाता है. ब्लड ग्लूकोज़ पॉइंट में, मिलीग्राम प्रति डेसीलीटर (mg/dL) में ग्लूकोज़ की मात्रा, खाने या समय का कॉन्टेक्स्ट, और सैंपल की जानकारी होती है.

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

ब्लड ग्लूकोज़ के लेवल के बारे में जानने के लिए, list एंडपॉइंट पर GET अनुरोध भेजें. यहां दिए गए उदाहरण में, दिखाई गई सूची से एक blood-glucose डेटा पॉइंट दिखाया गया है:

अनुरोध

GET https://health.googleapis.com/v4/users/me/dataTypes/blood-glucose/dataPoints?startTime=2026-04-20T08:00:00Z&endTime=2026-04-20T09:00:00Z
Authorization: Bearer access-token
Accept: application/json

जवाब

{
  "dataPoints": [
    {
      "name": "users/me/dataTypes/blood-glucose/dataPoints/bg-987654321",
      "dataSource": {
        "recordingMethod": "MANUALLY_ENTERED"
      },
      "bloodGlucose": {
        "sampleTime": {
          "physicalTime": "2026-04-20T08:30:00Z",
          "utcOffset": "-25200s"
        },
        "bloodGlucoseMilligramsPerDeciliter": 95.0,
        "measurementSource": "SELF_MONITORING_BLOOD_GLUCOSE",
        "mealType": "BREAKFAST",
        "measurementTiming": "AFTER_MEAL",
        "specimen": "CAPILLARY_BLOOD",
        "notes": "Post-breakfast fingerstick reading"
      }
    }
  ]
}

ऑक्सीजन की मात्रा (SpO2)

यह एपीआई, oxygen-saturation (दिन के दौरान के सैंपल की वैल्यू) और daily-oxygen-saturation (दिन के हिसाब से खास जानकारी के आंकड़े) का इस्तेमाल करके, ऑक्सीजन के लेवल को ट्रैक करता है. प्रतिशत की मात्रा को 0 से 100 के बीच की संख्या के तौर पर दिखाया जाता है.

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

ऑक्सीजन सेचुरेशन की माप के बारे में क्वेरी करने के लिए, list एंडपॉइंट पर GET अनुरोध भेजें. यहां दिए गए उदाहरण में, दिखाई गई सूची से एक oxygen-saturation डेटा पॉइंट दिखाया गया है:

अनुरोध

GET https://health.googleapis.com/v4/users/me/dataTypes/oxygen-saturation/dataPoints?startTime=2026-04-20T03:00:00Z&endTime=2026-04-20T03:05:00Z
Authorization: Bearer access-token
Accept: application/json

जवाब

{
  "dataPoints": [
    {
      "name": "users/me/dataTypes/oxygen-saturation/dataPoints/spo2-555555",
      "dataSource": {
        "recordingMethod": "ACTIVELY_MEASURED"
      },
      "oxygenSaturation": {
        "sampleTime": {
          "physicalTime": "2026-04-20T03:00:00Z",
          "utcOffset": "0s"
        },
        "percentage": 98.2
      }
    }
  ]
}

तापमान

तापमान को ट्रैक करने की सुविधा में, शरीर के अंदरूनी अंगों के तापमान की मेट्रिक और रात भर सोने के दौरान त्वचा के तापमान के ट्रेंड शामिल हैं:

  • शरीर का तापमान (core-body-temperature): यह शरीर के अंदरूनी अंगों के तापमान को सेल्सियस में रिकॉर्ड करता है. साथ ही, यह भी बताता है कि तापमान कहां से मेज़र किया गया है. जैसे, ARMPIT, EAR या FOREHEAD.
  • नींद के दौरान त्वचा के तापमान में होने वाले बदलाव (daily-sleep-temperature-derivations): रात भर में त्वचा के तापमान में होने वाले बदलावों को रिकॉर्ड किया जाता है.

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

शरीर के मुख्य तापमान की माप के बारे में क्वेरी करने के लिए, list एंडपॉइंट पर GET अनुरोध भेजें. यहां दिए गए उदाहरण में, दिखाई गई सूची से एक core-body-temperature डेटा पॉइंट दिखाया गया है:

अनुरोध

GET https://health.googleapis.com/v4/users/me/dataTypes/core-body-temperature/dataPoints?startTime=2026-04-20T22:00:00Z&endTime=2026-04-20T23:00:00Z
Authorization: Bearer access-token
Accept: application/json

जवाब

{
  "dataPoints": [
    {
      "name": "users/me/dataTypes/core-body-temperature/dataPoints/cbt-666666",
      "dataSource": {
        "recordingMethod": "ACTIVELY_MEASURED"
      },
      "coreBodyTemperature": {
        "sampleTime": {
          "physicalTime": "2026-04-20T22:30:00Z",
          "utcOffset": "-18000s"
        },
        "temperatureCelsius": 36.8,
        "measurementLocation": "FOREHEAD"
      }
    }
  ]
}

इलेक्ट्रोकार्डियोग्राम (ईसीजी रीडिंग) और सूचनाएँ

मेडिकल ग्रेड के सेंसर वाले डिवाइसों के लिए, एपीआई दिल की सेहत से जुड़े डेटा टाइप के बारे में ज़्यादा जानकारी देता है:

  • इलेक्ट्रोकार्डियोग्राम (electrocardiogram): सिंगल-लीड ईसीजी सेशन के नतीजे. इनमें क्लासिफ़िकेशन (SINUS_RHYTHM, ATRIAL_FIBRILLATION, INCONCLUSIVE), दिल की औसत धड़कन, सैंपलिंग फ़्रीक्वेंसी, और रॉ वेवफ़ॉर्म वोल्टेज सैंपल शामिल होते हैं.
  • दिल की धड़कन अनियमित होने पर मिलने वाली सूचना (irregular-rhythm-notification): कॉन्टेक्स्ट के हिसाब से सूचना देने वाले इवेंट. इनसे पैसिव मॉनिटरिंग के दौरान, अनियमित धड़कन के संभावित लक्षणों का पता चलता है.

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

इलेक्ट्रोकार्डियोग्राम सेशन के डेटा के बारे में क्वेरी करने के लिए, list एंडपॉइंट को GET अनुरोध भेजें. यहां दिए गए उदाहरण में, दिखाई गई सूची से एक electrocardiogram डेटा पॉइंट दिखाया गया है:

अनुरोध

GET https://health.googleapis.com/v4/users/me/dataTypes/electrocardiogram/dataPoints?startTime=2026-04-20T10:00:00Z&endTime=2026-04-20T10:05:00Z
Authorization: Bearer access-token
Accept: application/json

जवाब

{
  "dataPoints": [
    {
      "name": "users/me/dataTypes/electrocardiogram/dataPoints/ecg-777777",
      "dataSource": {
        "recordingMethod": "ACTIVELY_MEASURED"
      },
      "electrocardiogram": {
        "interval": {
          "startTime": "2026-04-20T10:00:00Z",
          "startUtcOffset": "0s",
          "endTime": "2026-04-20T10:00:30Z",
          "endUtcOffset": "0s"
        },
        "resultClassification": "SINUS_RHYTHM",
        "beatsPerMinuteAvg": "70",
        "samplingFrequencyHertz": 250,
        "millivoltsScalingFactor": 1000,
        "leadNumber": 1,
        "waveformSamples": [
          -12, -8, 4, 18, 30, 42, 50, 48, 32, 10
        ]
      }
    }
  ]
}

स्कोप और अनुमति

बीपी, धड़कन की दर वगैरह और दिल की सेहत का डेटा की सुविधा का इस्तेमाल करने के लिए, आपके ऐप्लिकेशन को OAuth के इन स्कोप का अनुरोध करना होगा:

  • पढ़ें: https://www.googleapis.com/auth/googlehealth.ecg.readonly
  • पढ़ें: https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.readonly
  • लिखें: https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.writeonly
  • पढ़ें: https://www.googleapis.com/auth/googlehealth.irn.readonly

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

वाइटल्स और सेहत से जुड़ी मेट्रिक वाली सुविधाओं को डिज़ाइन करते समय, इन दिशा-निर्देशों का पालन करें:

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