डेटा टाइप

Google Fit, com.google नेमस्पेस के तहत सेहत और तंदुरुस्ती से जुड़ा डेटा टाइप उपलब्ध कराता है.

डेटा टाइप से, डेटा पॉइंट में वैल्यू का फ़ॉर्मैट तय होता है. डेटा पॉइंट से यह जानकारी मिल सकती है:

  • तुरंत पढ़ने या निगरानी करने में मदद मिलती है
  • किसी समय अंतराल के आंकड़ों वाला समुच्चय डालें

Google Fit, कुल डेटा के लिए डेटा टाइप और तुरंत निगरानी करने के लिए डेटा टाइप तय करता है. डेटा पॉइंट में, डेटा टाइप के फ़ील्ड के लिए वैल्यू और टाइमस्टैंप की जानकारी होती है. तुरंत निगरानी करने वाले पॉइंट में टाइमस्टैंप शामिल होता है. साथ ही, एग्रीगेट किए गए डेटा टाइप के पॉइंट में, इंटरवल के शुरू होने का समय भी शामिल होता है.

Google Fit आपको नए डेटा टाइप तय करने की सुविधा भी देता है.

डेटा टाइप ग्रुप

Google Fit में ये डेटा टाइप होते हैं:

सार्वजनिक डेटा टाइप
प्लैटफ़ॉर्म से मिलने वाले स्टैंडर्ड डेटा टाइप में 'com.google' प्रीफ़िक्स होता है. उदाहरण के लिए, com.google.step_count.delta. इन डेटा टाइप में सेहत और तंदुरुस्ती से जुड़े डेटा के लिए, तुरंत रीडिंग कैप्चर की जाती है. इसमें फ़िटनेस से जुड़ी गतिविधि, नींद, और पोषण शामिल है. कोई भी ऐप्लिकेशन, इस तरह के डेटा को देखने और उसमें बदलाव करने के लिए ज़रूरी अनुमतियों का अनुरोध कर सकता है. हालांकि, जगह की जानकारी के कुछ ऐसे डेटा टाइप नहीं हो सकते जिन्हें सिर्फ़ लिखने वाला ऐप्लिकेशन ही पढ़ सकता है.

ज़्यादा जानकारी के लिए, ये देखें:

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

डेटा टाइप का इस्तेमाल करना

Android

Android पर, डेटा टाइप को DataType क्लास के सार्वजनिक फ़ील्ड के तौर पर बताया जाता है. आपको डेटा टाइप के साथ Fitness API को कैसे शुरू करना है, यह इस बात पर निर्भर करता है कि आपका लक्ष्य क्या है:

  • अगर आपको डेटा रिकॉर्ड करना है, तो रिकॉर्डिंग एपीआई का इस्तेमाल करके, हर उस डेटा टाइप के लिए सदस्यता बनाएं जिसे आपको रिकॉर्ड करना है.
  • डेटा पढ़ने के लिए, इतिहास एपीआई का इस्तेमाल करके हर तरह के डेटा के लिए, पढ़ने का अनुरोध सबमिट करें.
  • पुराना डेटा डालने के लिए, इतिहास एपीआई का इस्तेमाल करके, हर तरह के डेटा को शामिल करने का अनुरोध सबमिट करें.
  • सेशन बनाने के लिए, सेशन मेटाडेटा के साथ डेटा डालने या रिकॉर्ड करने के लिए, सेशन एपीआई का इस्तेमाल करें.

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

val nutritionSource = DataSource.Builder()
    .setDataType(DataType.TYPE_NUTRITION)
    ...
    .build()

val nutrients = mapOf(
    Field.NUTRIENT_TOTAL_FAT to 0.4f,
    Field.NUTRIENT_SODIUM to 1f,
    Field.NUTRIENT_POTASSIUM to 422f
)
val banana = DataPoint.builder(nutritionSource)
    .setTimestamp(now, TimeUnit.MILLISECONDS)
    .setField(Field.FIELD_FOOD_ITEM, "banana")
    .setField(Field.FIELD_MEAL_TYPE, Field.MEAL_TYPE_SNACK)
    .setField(Field.FIELD_NUTRIENTS, nutrients)
    .build()

अपने ऐप्लिकेशन में डेटा पॉइंट सेट करने के बाद, आपके पास इतिहास एपीआई की मदद से पुराना डेटा डालने, पढ़ने या मिटाने का विकल्प होता है.

आराम

dataSources संसाधन में हर डेटा सोर्स का डेटा टाइप और उसके फ़ील्ड की सूची शामिल होती है. डेटा सोर्स बनाते समय इनमें से कोई एक डेटा टाइप तय किया जा सकता है. साथ ही, फ़िटनेस स्टोर से डेटा सोर्स फ़ेच करने पर, आपको डेटा टाइप का नाम और उसके फ़ील्ड की सूची मिल सकती है.

उदाहरण के लिए, दिखाए गए डेटा सोर्स में उसके डेटा टाइप की जानकारी इस तरह से दी जाती है:

{
"dataStreamId": "exampleDataSourceId",
...
"dataType": {
  "name": "com.google.step_count.delta"
},
...
}

अनुमति के दायरे

ऑथराइज़ेशन स्कोप में डेटा टाइप के ऐसे ग्रुप शामिल होते हैं जिन्हें ऐक्सेस करने के लिए, उपयोगकर्ता किसी ऐप्लिकेशन को अनुमति दे सकता है. इनसे उपयोगकर्ताओं को यह समझने में मदद मिलती है कि कोई ऐप्लिकेशन किस तरह का डेटा ऐक्सेस करना चाहता है. वे हर अलग-अलग डेटा प्रकार को मंज़ूरी न देकर ऐप्लिकेशन को उस डेटा का इस्तेमाल करने की अनुमति देना भी आसान बना देती हैं. आपका ऐप्लिकेशन डाउनलोड करने के बाद, उपयोगकर्ता इन्हें अनुमतियां दे देते हैं.

ऐसी स्क्रीन का उदाहरण जिसमें OAuth के स्कोप के लिए सहमति दी गई है
दूसरी इमेज.OAuth, सहमति वाली स्क्रीन का स्कोप तय करती है.

कुछ उपयोगकर्ताओं के साथ अपने ऐप्लिकेशन की जांच करने के बाद, उसे लॉन्च करने से पहले आपको उन डेटा टाइप से जुड़े दायरों के आधार पर पुष्टि करने का अनुरोध करना होगा. ऊपर लिंक किए गए डेटा टाइप पेजों को पढ़ें और समझें कि हर डेटा टाइप पर कौनसे स्कोप लागू होते हैं.

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

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

इस टेबल का इस्तेमाल करके देखें कि आपके ऐप्लिकेशन को जिन दायरों का ऐक्सेस चाहिए वे संवेदनशील हैं या सीमित हैं. इससे तय होता है कि आपको पुष्टि करने का तरीका अपनाना होगा या नहीं:

स्कोप कंपनी का ब्यौरा कैटगरी
https://www.googleapis.com/auth/fitness.activity.read Google Fit प्लैटफ़ॉर्म से, गतिविधि का डेटा पढ़ने की सुविधा मिलती है. सभी देशों/इलाकों में उपलब्ध नहीं है
https://www.googleapis.com/auth/fitness.activity.write Google Fit प्लैटफ़ॉर्म पर गतिविधि का डेटा सेव करना सभी देशों/इलाकों में उपलब्ध नहीं है
https://www.googleapis.com/auth/fitness.blood_glucose.read Google Fit प्लैटफ़ॉर्म से मिलने वाला ब्लड ग्लूकोज़ का डेटा पढ़ें. सभी देशों/इलाकों में उपलब्ध नहीं है
https://www.googleapis.com/auth/fitness.blood_glucose.write Google Fit प्लैटफ़ॉर्म पर ब्लड ग्लूकोज़ का डेटा लिखें. सभी देशों/इलाकों में उपलब्ध नहीं है
https://www.googleapis.com/auth/fitness.blood_pressure.read Google Fit प्लैटफ़ॉर्म से ब्लड प्रेशर का डेटा पढ़ें. सभी देशों/इलाकों में उपलब्ध नहीं है
https://www.googleapis.com/auth/fitness.blood_pressure.write Google Fit प्लेटफ़ॉर्म पर ब्लड प्रेशर का डेटा लिखें. सभी देशों/इलाकों में उपलब्ध नहीं है
https://www.googleapis.com/auth/fitness.body.read Google Fit प्लैटफ़ॉर्म से, शरीर की माप का डेटा (ऊंचाई, वज़न, बॉडी फ़ैट का प्रतिशत) पढ़ें. सभी देशों/इलाकों में उपलब्ध नहीं है
https://www.googleapis.com/auth/fitness.body.write Google Fit प्लैटफ़ॉर्म पर शरीर की माप का डेटा लिखें. सभी देशों/इलाकों में उपलब्ध नहीं है
https://www.googleapis.com/auth/fitness.body_temperature.read Google Fit प्लैटफ़ॉर्म से शरीर के तापमान का डेटा पढ़ने की सुविधा. सभी देशों/इलाकों में उपलब्ध नहीं है
https://www.googleapis.com/auth/fitness.body_temperature.write Google Fit प्लैटफ़ॉर्म पर शरीर के तापमान का डेटा लिखें. सभी देशों/इलाकों में उपलब्ध नहीं है
https://www.googleapis.com/auth/fitness.heart_rate.read Google Fit प्लैटफ़ॉर्म से धड़कन की दर का डेटा पढ़ें. सभी देशों/इलाकों में उपलब्ध नहीं है
https://www.googleapis.com/auth/fitness.heart_rate.write Google Fit प्लैटफ़ॉर्म पर धड़कन की दर का डेटा लिखें. सभी देशों/इलाकों में उपलब्ध नहीं है
https://www.googleapis.com/auth/fitness.location.read Google Fit प्लैटफ़ॉर्म से, जगह की जानकारी का डेटा पढ़ने की सुविधा. सभी देशों/इलाकों में उपलब्ध नहीं है
https://www.googleapis.com/auth/fitness.location.write Google Fit प्लैटफ़ॉर्म पर जगह की जानकारी का डेटा सेव करना. सभी देशों/इलाकों में उपलब्ध नहीं है
https://www.googleapis.com/auth/fitness.nutrition.read Google Fit प्लैटफ़ॉर्म से पोषण का डेटा पढ़ें. सभी देशों/इलाकों में उपलब्ध नहीं है
https://www.googleapis.com/auth/fitness.nutrition.write Google Fit प्लैटफ़ॉर्म पर पोषण से जुड़ा डेटा लिखें. सभी देशों/इलाकों में उपलब्ध नहीं है
https://www.googleapis.com/auth/fitness.oxygen_saturation.read Google Fit प्लैटफ़ॉर्म से ऑक्सीजन सेचुरेशन का डेटा पढ़ें. सभी देशों/इलाकों में उपलब्ध नहीं है
https://www.googleapis.com/auth/fitness.oxygen_saturation.write Google Fit प्लैटफ़ॉर्म पर ऑक्सीजन सेचुरेशन का डेटा लिखें. सभी देशों/इलाकों में उपलब्ध नहीं है
https://www.googleapis.com/auth/fitness.reproductive_health.read Google Fit प्लैटफ़ॉर्म पर मौजूद प्रजनन स्वास्थ्य की जानकारी का डेटा पढ़ें. सभी देशों/इलाकों में उपलब्ध नहीं है
https://www.googleapis.com/auth/fitness.reproductive_health.write Google Fit प्लैटफ़ॉर्म पर प्रजनन स्वास्थ्य की जानकारी से जुड़ा डेटा लिखें. सभी देशों/इलाकों में उपलब्ध नहीं है
https://www.googleapis.com/auth/fitness.sleep.read Google Fit के प्लैटफ़ॉर्म पर मौजूद, नींद से जुड़ा डेटा ऐक्सेस किया जा सकता है. सभी देशों/इलाकों में उपलब्ध नहीं है
https://www.googleapis.com/auth/fitness.sleep.write Google Fit प्लैटफ़ॉर्म पर नींद से जुड़ा डेटा लिखें. सभी देशों/इलाकों में उपलब्ध नहीं है

किसी मौजूदा ऐप्लिकेशन में नए दायरे जोड़ना

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

जब आपको संसाधनों की ज़रूरत हो, तब उपयोगकर्ताओं से उनकी अनुमति का अनुरोध करना सबसे सही तरीका होता है. ज़्यादा अनुमति का अनुरोध करने के लिए, दिशा-निर्देशों का पालन करें.

अगर उपयोगकर्ता यह समझ जाते हैं कि आपका ऐप्लिकेशन इस डेटा का इस्तेमाल क्यों/कैसे करता है, तो उनके ऐक्सेस देने की संभावना ज़्यादा होती है:

  • ऐसी स्क्रीन जोड़ने पर विचार करें जो उपयोगकर्ताओं को चेतावनी देती/सूचना देती हो कि उनसे इन दायरों के बारे में पूछा जाएगा.
  • साफ़ तौर पर बताएं कि आपका ऐप्लिकेशन इन दायरों/डेटा का ऐक्सेस क्यों मांग रहा है, ताकि उपयोगकर्ता सोच-समझकर फ़ैसला ले सकें.

Android के लिए ऐप्लिकेशन अनुमतियों के बारे में सबसे सही तरीकों के बारे में ज़्यादा जानें.