डेटा टाइप

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

डेटा टाइप, डेटा पॉइंट के अंदर वैल्यू का फ़ॉर्मैट तय करते हैं. डेटा पॉइंट इनके बारे में बता सकता है:

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

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

Google Fit की मदद से नए तरह के डेटा भी तय किए जा सकते हैं.

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

Google Fit में इस तरह का डेटा है:

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

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

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

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

Android

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

  • डेटा रिकॉर्ड करने के लिए, Recording API का इस्तेमाल करके, ऐसे हर डेटा टाइप की सदस्यता बनाएं जिसे आपको रिकॉर्ड करना है.
  • डेटा पढ़ने के लिए, हर तरह के डेटा के लिए, पढ़ने का अनुरोध सबमिट करें. इसके लिए, इतिहास एपीआई का इस्तेमाल करें.
  • पुराने डेटा को शामिल करने के लिए, इतिहास एपीआई का इस्तेमाल करके हर तरह के डेटा को शामिल करने का अनुरोध सबमिट करें.
  • सत्र बनाने के लिए, सत्र मेटाडेटा के साथ डेटा डालने या रिकॉर्ड करने के लिए सत्र 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()

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

REST

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 फ़िट' प्लैटफ़ॉर्म पर गतिविधि से जुड़ा डेटा लिखना सभी देशों/इलाकों में उपलब्ध नहीं है
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 के लिए ऐप्लिकेशन अनुमतियों के सबसे सही तरीकों के बारे में ज़्यादा जानें.