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

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

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 DSL

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 प्लैटफ़ॉर्म पर, कस्टम डेटा टाइप और सेटिंग ऐक्सेस करें.

फ़िटनेस एपीआई क्लाइंट बनाने का उदाहरण देखें.

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

यहां अनुमति देने की प्रोसेस के बारे में बताया गया है. उपयोगकर्ताओं को अनुमति देने के लिए कहा जाने पर, उन्हें यह प्रोसेस पूरी करनी होती है:

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

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

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

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