डेटा प्रकार

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()

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

आराम

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