इस पेज का अनुवाद Cloud Translation API से किया गया है.

Android पर इस्तेमाल शुरू करें

इस गाइड में, Android पर Google Fit को डेवलप करने का तरीका बताया गया है.

सेटअप

अपना ऐप्लिकेशन बनाना शुरू करने से पहले, नीचे दिए गए सेक्शन में बताया गया तरीका अपनाएं.

कोई Google खाता प्राप्त करें

Google Fit API का इस्तेमाल करने के लिए, आपके पास एक Google खाता होना चाहिए. आप नया खाता बना सकते हैं या किसी मौजूदा खाते का उपयोग कर सकते हैं. आपको अपने ऐप्लिकेशन की जांच, उपयोगकर्ता के नज़रिए से करने के लिए, अलग से खाता बनाना पड़ सकता है.

Google Play सेवाएं पाएं

Google Play services के लिए, अपने डेवलपमेंट होस्ट पर सबसे नई क्लाइंट लाइब्रेरी पाएं:

Android SDK Manager खोलें.
SDK टूल में Google Play सेवाएं ढूंढें.
अगर इन पैकेज के लिए स्थिति इंस्टॉल किए गए नहीं है, तो दोनों को चुनें और पैकेज इंस्टॉल करें पर क्लिक करें.

OAuth 2.0 क्लाइंट आईडी पाना

फ़िटनेस एपीआई चालू करने के लिए, OAuth 2.0 क्लाइंट आईडी पाना.

प्रोजेक्ट बनाना और कॉन्फ़िगर करना

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

Google Play services की क्लाइंट लाइब्रेरी जोड़ना

Android Studio में, अपने मॉड्यूल के लिए build.gradle फ़ाइल खोलें और Google Play सेवाओं की क्लाइंट लाइब्रेरी को डिपेंडेंसी के तौर पर जोड़ें:

Kotlin डीएसएल

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.1.0")
        implementation("com.google.android.gms:play-services-auth:20.7.0")
}

ग्रूवी डीएसएल

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.1.0'
    implementation 'com.google.android.gms:play-services-auth:20.7.0'
}

इससे यह पक्का होता है कि जब आपका ऐप्लिकेशन बने, तो Gradle फ़िटनेस SDK टूल को अपने-आप डाउनलोड कर ले.

अपना ऐप्लिकेशन बनाना और उसकी जांच करना

सेटअप चरण पूरे करने के बाद, आप अपना ऐप्लिकेशन बनाना शुरू कर सकते हैं. शुरू करने के लिए, डेटा के प्रकारअपने ऐप्लिकेशन को सेव करें औरपढ़ें. 'Google फ़िट' में डेटा के साथ काम करने के बारे में ज़्यादा जानें.

Android के लिए ज़रूरी अनुमतियां पाना

कुछ खास तरह का डेटा पढ़ने और लिखने के लिए, आपके ऐप्लिकेशन को Android की अनुमतियों का अनुरोध करना होगा.

OAuth की अनुमतियां लें

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

एपीआई क्लाइंट बनाना

एपीआई क्लाइंट बनाएं और ऐसे डेटा टाइप जोड़ें जिन्हें ऐक्सेस करने के लिए आपके ऐप्लिकेशन को डेटा ऐक्सेस करना होगा. नीचे दिए गए एंडपॉइंट उपलब्ध हैं:

SensorsClient: लोकल डिवाइस और साथी डिवाइसों में मौजूद, हार्डवेयर सेंसर से सेहत और तंदुरुस्ती से जुड़े डेटा के अलग-अलग सोर्स ऐक्सेस करें.
RecordingClient: लो-पावर के लिए, हमेशा चालू रहने वाला सेंसर डेटा इकट्ठा करें.
HistoryClient: Google Fit में पुराना डेटा डालें, मिटाएं, और पढ़ें.
SessionsClient: उपयोगकर्ता गतिविधि के सेशन बनाएं और मैनेज करें.
GoalsClient: 'Google फ़िट' के उपयोगकर्ताओं के बनाए गए 'हार्ट पॉइंट' और 'कदमों के लक्ष्य' पढ़ें.
ConfigClient: 'Google फ़िट' प्लैटफ़ॉर्म में डेटा के कस्टम टाइप और सेटिंग को ऐक्सेस करना.

Fitness API के क्लाइंट को बनाने का उदाहरण देखें.

नतीजे के तौर पर उपयोगकर्ता अनुमति देने का फ़्लो

यहां बताया गया है कि अनुमतियों के बारे में पूछे जाने पर, लोगों को किस नतीजे के तौर पर अनुमति देनी होती है:

**पहली इमेज.**उपयोगकर्ताओं के लिए अनुमति देने का फ़्लो.

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

पुष्टि के लिए आवेदन करें

अपना ऐप्लिकेशन बनाने और उसकी जांच करने के बाद, आपको संवेदनशील और पाबंदी वाले दायरों के लिए, ज़रूरी लेवल के अलग-अलग लेवल के साथ पुष्टि के लिए आवेदन करना होगा.