डेटा टाइप

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

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

• तात्कालिक रीडिंग या निरीक्षण
• किसी समय अंतराल पर आंकड़ों वाला एग्रीगेट

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

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

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

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

सार्वजनिक डेटा के टाइप

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

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

• गतिविधि के डेटा टाइप
• जगह की जानकारी का डेटा टाइप
• पोषण से जुड़े डेटा के टाइप

सेहत से जुड़े डेटा टाइप

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

एग्रीगेट किए गए डेटा टाइप

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

निजी कस्टम डेटा टाइप

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

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

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

Android

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

• डेटा रिकॉर्ड करने के लिए, 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()

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

आराम

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

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

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

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

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

दूसरी इमेज. 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 के लिए ऐप्लिकेशन की अनुमतियों से जुड़े सबसे सही तरीकों के बारे में ज़्यादा जानें.