Google Fit REST API के साथ-साथ, Google Fit के सभी एपीआई 2026 में बंद कर दिए जाएंगे. डेवलपर, 1 मई, 2024 से इन एपीआई का इस्तेमाल करने के लिए साइन अप नहीं कर सकते.

किस एपीआई या प्लैटफ़ॉर्म पर माइग्रेट करना है, इसके बारे में निर्देश पाने के लिए, Health Connect के माइग्रेशन से जुड़ी गाइड पर जाएं. Health Connect की तुलना Google Fit API और Fitbit वेब API से करने के लिए, Health Connect की तुलना करने से जुड़ी गाइड पर जाएं.

Health Connect के बारे में ज़्यादा जानें और एपीआई के साथ इंटिग्रेट करने का तरीका जानें.

Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

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

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

सेटअप

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

Google खाता पाएं

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

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

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

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

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

Fitness API को चालू करने के लिए, OAuth 2.0 क्लाइंट आईडी पाएं.

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

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

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

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

Kotlin डीएसएल

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

...

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

Groovy DSL

apply plugin: 'com.android.application'

...

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

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

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

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

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

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

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

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

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

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

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

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

उपयोगकर्ता के ऑथराइज़ेशन का नतीजा

यहां अनुमति मांगने पर, उपयोगकर्ताओं को दिखने वाला ऑथराइज़ेशन फ़्लो दिखाया गया है:

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

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

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

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