Health Connect का डेटा टाइप प्लान करें और उनकी समीक्षा करें

Health Connect में, सेहत और फ़िटनेस से जुड़ा डेटा सेव किया जाता है और उसे व्यवस्थित किया जाता है. इसमें यह भी शामिल होता है कि अलग-अलग तरह के डेटा को कैसे मेज़र किया जाता है. इस तरह के डेटा में, धड़कन की दर की तुरंत ली गई मेज़रमेंट, समय के साथ कदमों की संख्या, और सेशन में लिया गया नींद का डेटा शामिल होता है.

सबसे पहले यह समझना ज़रूरी है कि Health Connect, किस तरह का डेटा और अनुमतियां देता है. इससे आपको अपने ऐप्लिकेशन की ज़रूरतों के बारे में प्लान बनाने में मदद मिलेगी. इसके अलावा, आपको अपनी ज़रूरी शर्तों को पूरा करने से पहले, अपने डेटा टाइप की समीक्षा करनी होगी.

डेटा टाइप की कैटगरी

Health Connect, उन डेटा टाइप के साथ काम करता है जिनका इस्तेमाल ज़्यादातर सेहत और फ़िटनेस ऐप्लिकेशन में किया जाता है, ताकि ज़्यादा से ज़्यादा तरह का डेटा उपलब्ध कराया जा सके. Health Connect का मकसद, सेहत और फ़िटनेस से जुड़े डेटा को एक ही जगह पर सेव करना और उसे पूरी जानकारी के साथ दिखाना है. इस तरह के डेटा को इन कैटगरी में रखा जाता है:

  • गतिविधि: इससे उपयोगकर्ता की हर गतिविधि को कैप्चर किया जाता है. इसमें दौड़ना और तैरना जैसी सेहत और फ़िटनेस से जुड़ी गतिविधियां शामिल हो सकती हैं.
  • शरीर का मेज़रमेंट: यह शरीर से जुड़े सामान्य डेटा को कैप्चर करता है. जैसे, किसी व्यक्ति का वज़न और उसकी बेसल मेटाबॉलिक रेट.
  • पीरियड साइकल ट्रैक करना: इससे पीरियड साइकल और उससे जुड़े डेटा पॉइंट कैप्चर किए जाते हैं. जैसे, ऑव्युलेशन टेस्ट का बाइनरी नतीजा.
  • पोषण: इससे हाइड्रेशन और पोषण से जुड़े डेटा टाइप कैप्चर किए जाते हैं. पहले विकल्प से पता चलता है कि कोई व्यक्ति एक बार में कितना पानी पीता है. बाद वाले में, कैलोरी, शर्करा, और मैग्नीशियम जैसे वैकल्पिक फ़ील्ड शामिल हैं.
  • नींद: यह उपयोगकर्ता की नींद की अवधि और नींद के टाइप से जुड़ा डेटा कैप्चर करता है.
  • वाइटल्स: इससे उपयोगकर्ता की सामान्य सेहत के बारे में ज़रूरी जानकारी मिलती है. इसमें शरीर का तापमान, ब्लड ग्लूकोज़, ब्लड प्रेशर, और खून में ऑक्सीजन की मात्रा जैसी जानकारी शामिल होती है.

डेटा टाइप का फ़ॉर्मैट

Health Connect में मौजूद डेटा टाइप, ऐसे ऑब्जेक्ट में सेव होते हैं जो Record के सबक्लास होते हैं.

हर डेटा टाइप के लिए, उससे जुड़े फ़ील्ड होते हैं. ये फ़ील्ड सामान्य हो सकते हैं, जैसे कि time और zoneOffset. इसके अलावा, ये फ़ील्ड खास भी हो सकते हैं, जैसे कि title, count, और percentage. कुछ फ़ील्ड में सामान्य टाइप का इस्तेमाल किया जाता है. जैसे, long, double या string. वहीं, अन्य फ़ील्ड में जटिल टाइप का इस्तेमाल किया जाता है. जैसे, इन्यूमरेशन और Instant और ZoneOffset जैसी क्लास. इन फ़ील्ड के एट्रिब्यूट ज़रूरी या वैकल्पिक हो सकते हैं. कुछ एट्रिब्यूट सिर्फ़ पढ़ने के लिए होते हैं. साथ ही, कुछ एट्रिब्यूट के लिए वैल्यू की एक तय सीमा होती है.

उपलब्ध डेटा टाइप और उनके फ़ील्ड की पूरी सूची देखने के लिए, Jetpack में मौजूद क्लास देखें.

अन्य डेटा एट्रिब्यूट

Health Connect API में मौजूद डेटा में, मेटाडेटा एट्रिब्यूट भी शामिल होते हैं. इनके बारे में यहां बताया गया है:

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

Health Connect आईडी

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

Health Connect आईडी का इस्तेमाल करते समय, इन बातों का ध्यान रखें:

  • सेशन में एक Health Connect आईडी होता है, लेकिन सेशन में मौजूद डेटा के अपने Health Connect आईडी होते हैं.
  • Health Connect आईडी, टाइमस्टैंप से जुड़े नहीं होते हैं.
  • कुछ मामलों में, वर्कफ़्लो के दौरान किसी खास Health Connect आईडी को सेव करना पड़ सकता है. उदाहरण के लिए, किसी उपयोगकर्ता ने अभी-अभी जो डेटा एंट्री की है उसे वापस पाने और दिखाने के लिए, एक खास आईडी की ज़रूरत होती है.

Health Connect में समय

Health Connect में सेव किए गए सभी डेटा में, ज़ोन ऑफ़सेट की जानकारी शामिल होनी चाहिए. ज़ोन ऑफ़सेट की जानकारी देने से, ऐप्लिकेशन डेटा को पढ़कर उसे सिविल टाइम में दिखा पाते हैं. सिविल टाइम, उपयोगकर्ता के स्थानीय समय के हिसाब से होता है. हालांकि, यह ज़रूरी नहीं है कि यह कोऑर्डिनेटेड यूनिवर्सल टाइम (यूटीसी) में हो.

कुछ मामलों में, ज़ोन ऑफ़सेट उपलब्ध नहीं हो सकता. Android 14 (एपीआई लेवल 34) में ऐसा होने पर, Health Connect डिवाइस के सिस्टम के डिफ़ॉल्ट टाइम ज़ोन के आधार पर ज़ोन ऑफ़सेट सेट करता है. Android 13 और इससे पहले के वर्शन (एपीआई लेवल 33 और इससे पहले के वर्शन) में, ज़ोन ऑफ़सेट की जानकारी दिए बिना Health Connect में डेटा सेव किया जा सकता है. हालांकि, जब भी हो सके, ऐसा करने से बचना चाहिए.

टाइम और ज़ोन की सेटिंग

डेटा लिखते समय ज़ोन ऑफ़सेट की जानकारी देने से, Health Connect में डेटा पढ़ते समय टाइम ज़ोन की जानकारी मिलती है. हालांकि, कुछ स्थितियों में ऐसा नहीं हो पाता. जैसे, जब ज़ोन ऑफ़सेट की जानकारी नहीं दी जाती है. आपका ऐप्लिकेशन, दोनों तरह के डेटा को इस तरह से प्रोसेस करने के लिए तैयार होना चाहिए कि वह आपकी खास परिस्थितियों के हिसाब से काम करे.

अनुमतियां

कोई भी अनुमति मांगने से पहले, आपके ऐप्लिकेशन को मेनिफ़ेस्ट में उन्हें ज़ाहिर करना होगा. डेटा टाइप और उनकी अनुमतियों की पूरी मैपिंग के लिए, यहां दी गई टेबल देखें.

1.0.0-alpha10 और इसके बाद के वर्शन के लिए

अनुमति के बारे में जानकारी अनुमति के एलान को पढ़ना
बैकग्राउंड में डेटा ऐक्सेस करना android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND
इतिहास पढ़ें android.permission.health.READ_HEALTH_DATA_HISTORY

रिकॉर्ड क्लास टाइप पढ़ने और लिखने की अनुमति के बारे में एलान करना
ActiveCaloriesBurned android.permission.health.READ_ACTIVE_CALORIES_BURNED
android.permission.health.WRITE_ACTIVE_CALORIES_BURNED
BasalBodyTemperature android.permission.health.READ_BASAL_BODY_TEMPERATURE
android.permission.health.WRITE_BASAL_BODY_TEMPERATURE
BasalMetabolicRate android.permission.health.READ_BASAL_METABOLIC_RATE
android.permission.health.WRITE_BASAL_METABOLIC_RATE
BloodGlucose android.permission.health.READ_BLOOD_GLUCOSE
android.permission.health.WRITE_BLOOD_GLUCOSE
BloodPressure android.permission.health.READ_BLOOD_PRESSURE
android.permission.health.WRITE_BLOOD_PRESSURE
BodyFat android.permission.health.READ_BODY_FAT
android.permission.health.WRITE_BODY_FAT
BodyTemperature android.permission.health.READ_BODY_TEMPERATURE
android.permission.health.WRITE_BODY_TEMPERATURE
BodyWaterMass android.permission.health.READ_BODY_WATER_MASS
android.permission.health.WRITE_BODY_WATER_MASS
BoneMass android.permission.health.READ_BONE_MASS
android.permission.health.WRITE_BONE_MASS
CervicalMucus android.permission.health.READ_CERVICAL_MUCUS
android.permission.health.WRITE_CERVICAL_MUCUS
CyclingPedalingCadence android.permission.health.READ_EXERCISE
android.permission.health.WRITE_EXERCISE
दूरी android.permission.health.READ_DISTANCE
android.permission.health.WRITE_DISTANCE
ElevationGained android.permission.health.READ_ELEVATION_GAINED
android.permission.health.WRITE_ELEVATION_GAINED
ExerciseSession android.permission.health.READ_EXERCISE
android.permission.health.READ_EXERCISE_ROUTE
android.permission.health.WRITE_EXERCISE
android.permission.health.WRITE_EXERCISE_ROUTE

कसरत का टाइप

EXERCISE_TYPE_BIKING
EXERCISE_TYPE_BIKING_HAND
EXERCISE_TYPE_BIKING_MOUNTAIN
EXERCISE_TYPE_BIKING_ROAD
EXERCISE_TYPE_BIKING_SPINNING
EXERCISE_TYPE_BIKING_STATIONARY
EXERCISE_TYPE_BIKING_UTURN
EXERCISE_TYPE_CANOEING
EXERCISE_TYPE_CROSSFIT
EXERCISE_TYPE_DANCING
EXERCISE_TYPE_ELLIPTICAL
EXERCISE_TYPE_GOLF
EXERCISE_TYPE_HORSEBACK_RIDING
EXERCISE_TYPE_KAYAKING
EXERCISE_TYPE_KICKBOXING
EXERCISE_TYPE_MARTIAL_ARTS
EXERCISE_TYPE_PILATES
EXERCISE_TYPE_ROLLERBLADING
EXERCISE_TYPE_RUNNING
EXERCISE_TYPE_RUNNING_JOGGING
EXERCISE_TYPE_RUNNING_SAND
FloorsClimbed android.permission.health.READ_FLOORS_CLIMBED
android.permission.health.WRITE_FLOORS_CLIMBED
HeartRate android.permission.health.READ_HEART_RATE
android.permission.health.WRITE_HEART_RATE
HeartRateVariabilityRmssd android.permission.health.READ_HEART_RATE_VARIABILITY
android.permission.health.WRITE_HEART_RATE_VARIABILITY
ऊंचाई android.permission.health.READ_HEIGHT
android.permission.health.WRITE_HEIGHT
हाइड्रेशन android.permission.health.READ_HYDRATION
android.permission.health.WRITE_HYDRATION
IntermenstrualBleeding android.permission.health.READ_INTERMENSTRUAL_BLEEDING
android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING
LeanBodyMass android.permission.health.READ_LEAN_BODY_MASS
android.permission.health.WRITE_LEAN_BODY_MASS
MenstruationFlow android.permission.health.READ_MENSTRUATION
android.permission.health.WRITE_MENSTRUATION
MindfulnessSession android.permission.health.READ_MINDFULNESS
android.permission.health.WRITE_MINDFULNESS
पोषण android.permission.health.READ_NUTRITION
android.permission.health.WRITE_NUTRITION
OvulationTest android.permission.health.READ_OVULATION_TEST
android.permission.health.WRITE_OVULATION_TEST
OxygenSaturation android.permission.health.READ_OXYGEN_SATURATION
android.permission.health.WRITE_OXYGEN_SATURATION
PlannedExerciseSession android.permission.health.READ_PLANNED_EXERCISE
android.permission.health.WRITE_PLANNED_EXERCISE
पावर android.permission.health.READ_POWER
android.permission.health.WRITE_POWER
RespiratoryRate android.permission.health.READ_RESPIRATORY_RATE
android.permission.health.WRITE_RESPIRATORY_RATE
RestingHeartRate android.permission.health.READ_RESTING_HEART_RATE
android.permission.health.WRITE_RESTING_HEART_RATE
SexualActivity android.permission.health.READ_SEXUAL_ACTIVITY
android.permission.health.WRITE_SEXUAL_ACTIVITY
SkinTemperature android.permission.health.READ_SKIN_TEMPERATURE
android.permission.health.WRITE_SKIN_TEMPERATURE
SleepSession android.permission.health.READ_SLEEP
android.permission.health.WRITE_SLEEP
स्पीड android.permission.health.READ_SPEED
android.permission.health.WRITE_SPEED
तरीका android.permission.health.READ_STEPS
android.permission.health.WRITE_STEPS
StepsCadence android.permission.health.READ_STEPS
android.permission.health.WRITE_STEPS
TotalCaloriesBurned android.permission.health.READ_TOTAL_CALORIES_BURNED
android.permission.health.WRITE_TOTAL_CALORIES_BURNED
VO2Max android.permission.health.READ_VO2_MAX
android.permission.health.WRITE_VO2_MAX
वज़न android.permission.health.READ_WEIGHT
android.permission.health.WRITE_WEIGHT
WheelchairPushes android.permission.health.READ_WHEELCHAIR_PUSHES
android.permission.health.WRITE_WHEELCHAIR_PUSHES

1.0.0-alpha09 और इससे पहले के वर्शन के लिए

रिकॉर्ड क्लास टाइप पढ़ने और लिखने की अनुमति के बारे में एलान करना
ActiveCaloriesBurned androidx.health.permission.ActiveCaloriesBurned.READ
androidx.health.permission.ActiveCaloriesBurned.WRITE
BasalBodyTemperature androidx.health.permission.BasalBodyTemperature.READ
androidx.health.permission.BasalBodyTemperature.WRITE
BasalMetabolicRate androidx.health.permission.BasalMetabolicRate.READ
androidx.health.permission.BasalMetabolicRate.WRITE
BloodGlucose androidx.health.permission.BloodGlucose.READ
androidx.health.permission.BloodGlucose.WRITE
BloodPressure androidx.health.permission.BloodPressure.READ
androidx.health.permission.BloodPressure.WRITE
BodyFat androidx.health.permission.BodyFat.READ
androidx.health.permission.BodyFat.WRITE
BodyTemperature androidx.health.permission.BodyTemperature.READ
androidx.health.permission.BodyTemperature.WRITE
BodyWaterMass androidx.health.permission.BodyWaterMass.READ
androidx.health.permission.BodyWaterMass.WRITE
BoneMass androidx.health.permission.BoneMass.READ
androidx.health.permission.BoneMass.WRITE
CervicalMucus androidx.health.permission.CervicalMucus.READ
androidx.health.permission.CervicalMucus.WRITE
CyclingPedalingCadence androidx.health.permission.Exercise.READ
androidx.health.permission.Exercise.WRITE
दूरी androidx.health.permission.Distance.READ
androidx.health.permission.Distance.WRITE
ElevationGained androidx.health.permission.ElevationGained.READ
androidx.health.permission.ElevationGained.WRITE
ExerciseSession androidx.health.permission.ExerciseSession.READ
androidx.health.permission.ExerciseSession.WRITE

कसरत का टाइप

EXERCISE_TYPE_BIKING
EXERCISE_TYPE_BIKING_HAND
EXERCISE_TYPE_BIKING_MOUNTAIN
EXERCISE_TYPE_BIKING_ROAD
EXERCISE_TYPE_BIKING_SPINNING
EXERCISE_TYPE_BIKING_STATIONARY
EXERCISE_TYPE_BIKING_UTURN
EXERCISE_TYPE_CANOEING
EXERCISE_TYPE_CROSSFIT
EXERCISE_TYPE_DANCING
EXERCISE_TYPE_ELLIPTICAL
EXERCISE_TYPE_GOLF
EXERCISE_TYPE_HORSEBACK_RIDING
EXERCISE_TYPE_KAYAKING
EXERCISE_TYPE_KICKBOXING
EXERCISE_TYPE_MARTIAL_ARTS
EXERCISE_TYPE_PILATES
EXERCISE_TYPE_ROLLERBLADING
EXERCISE_TYPE_RUNNING
EXERCISE_TYPE_RUNNING_JOGGING
EXERCISE_TYPE_RUNNING_SAND
FloorsClimbed androidx.health.permission.FloorsClimbed.READ
androidx.health.permission.FloorsClimbed.WRITE
HeartRate androidx.health.permission.HeartRate.READ
androidx.health.permission.HeartRate.WRITE
HeartRateVariabilityRmssd androidx.health.permission.HeartRateVariability.READ
androidx.health.permission.HeartRateVariability.WRITE
ऊंचाई androidx.health.permission.Height.READ
androidx.health.permission.Height.WRITE
हाइड्रेशन androidx.health.permission.Hydration.READ
androidx.health.permission.Hydration.WRITE
IntermenstrualBleeding androidx.health.permission.IntermenstrualBleeding.READ
androidx.health.permission.IntermenstrualBleeding.WRITE
LeanBodyMass androidx.health.permission.LeanBodyMass.READ
androidx.health.permission.LeanBodyMass.WRITE
MenstruationFlow androidx.health.permission.Menstruation.READ
androidx.health.permission.Menstruation.WRITE
पोषण androidx.health.permission.Nutrition.READ
androidx.health.permission.Nutrition.WRITE
OvulationTest androidx.health.permission.OvulationTest.READ
androidx.health.permission.OvulationTest.WRITE
OxygenSaturation androidx.health.permission.OxygenSaturation.READ
androidx.health.permission.OxygenSaturation.WRITE
PlannedExerciseSession androidx.health.permission.PlannedExerciseSession.READ
androidx.health.permission.PlannedExerciseSession.WRITE
पावर androidx.health.permission.Power.READ
androidx.health.permission.Power.WRITE
RespiratoryRate androidx.health.permission.RespiratoryRate.READ
androidx.health.permission.RespiratoryRate.WRITE
RestingHeartRate androidx.health.permission.RestingHeartRate.READ
androidx.health.permission.RestingHeartRate.WRITE
SexualActivity androidx.health.permission.SexualActivity.READ
androidx.health.permission.SexualActivity.WRITE
SleepSession androidx.health.permission.SleepSession.READ
androidx.health.permission.SleepSession.WRITE
स्पीड androidx.health.permission.Speed.READ
androidx.health.permission.Speed.WRITE
तरीका androidx.health.permission.Steps.READ
androidx.health.permission.Steps.WRITE
StepsCadence androidx.health.permission.Steps.READ
androidx.health.permission.Steps.WRITE
TotalCaloriesBurned androidx.health.permission.TotalCaloriesBurned.READ
androidx.health.permission.TotalCaloriesBurned.WRITE
VO2Max androidx.health.permission.VO2Max.READ
androidx.health.permission.VO2Max.WRITE
वज़न androidx.health.permission.Weight.READ
androidx.health.permission.Weight.WRITE
WheelchairPushes androidx.health.permission.WheelchairPushes.READ
androidx.health.permission.WheelchairPushes.WRITE

अपने डेटा टाइप और अनुमतियों की समीक्षा करना

अब जब आपने डेटा टाइप और अनुमतियों के बारे में प्लान बना लिया है, तो डेवलपमेंट के दौरान उन्हें लागू किया जा सकता है.

Play Store पर ऐप्लिकेशन अपलोड करने से पहले, उसकी समीक्षा करते समय, डेटा टाइप और अनुमतियों की उस सूची की दोबारा जांच करें जिनकी आपके ऐप्लिकेशन को ज़रूरत है. इससे आपको ऐप्लिकेशन के डेटा इस्तेमाल करने के तरीके के बारे में सटीक जानकारी देने में मदद मिलती है.

Play Store पर अपना ऐप्लिकेशन पब्लिश करने से पहले, Health Connect के उन डेटा टाइप को ऐक्सेस करने का एलान करें जिनका इस्तेमाल आपका ऐप्लिकेशन करता है. ऐसा न करने पर, उपयोगकर्ताओं को गड़बड़ी का मैसेज दिख सकता है. इसमें बताया जाएगा कि आपका ऐप्लिकेशन, Health Connect के डेटा टाइप को ऐक्सेस नहीं कर सकता, क्योंकि इसके लिए खास अनुमति की ज़रूरत होती है.