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

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

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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

सेटअप

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

Google खाता पाएं

Google Fit के एपीआई का इस्तेमाल करने के लिए, आपके पास एक 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:21.5.1")
}

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:21.5.1'
}

इससे यह पक्का होता है कि 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 स्कोप की अनुमति देने के लिए कहता है जिन्हें वह ऐक्सेस करना चाहता है.
ऐक्सेस लागू किया गया: उपयोगकर्ता की ओर से अनुमतियां देने के बाद, आपका ऐप्लिकेशन उन डेटा टाइप को ऐक्सेस कर सकता है जो उन स्कोप से जुड़े हैं जिनके लिए उपयोगकर्ता ने अनुमति दी है.

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

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