OAuth2 Playground का इस्तेमाल करके, Google Health API को पहली बार कॉल करना

1. परिचय

OAuth 2.0 Playground एक वेब-आधारित टूल है. इसकी मदद से, Google OAuth 2.0 फ़्लो को बिना कोई कोड लिखे टेस्ट किया जा सकता है. इस कोडलैब में, आपको Google Cloud प्रोजेक्ट सेट अप करने, क्रेडेंशियल पाने, OAuth 2.0 Playground के साथ अनुमति देने का फ़्लो शुरू करने, और Google Health API के किसी एक एंडपॉइंट पर पहला कॉल करने का तरीका बताया जाएगा.

आपको क्या सीखने को मिलेगा

• Google Cloud Console में क्लाइंट आईडी सेट अप करने का तरीका.
• OAuth 2.0 Playground का इस्तेमाल करके, ऐक्सेस टोकन और रीफ़्रेश टोकन पाने के लिए, Google OAuth 2.0 के ऑथराइज़ेशन फ़्लो को पूरा करने का तरीका.
• OAuth 2.0 Playground का इस्तेमाल करके, Google Health API के एंडपॉइंट को कॉल करने का तरीका.

आपको किन चीज़ों की ज़रूरत होगी

• एक Google खाता
• Fitbit का मोबाइल ऐप्लिकेशन
• OAuth 2.0 Playground

Fitbit मोबाइल ऐप्लिकेशन सेट अप करने के लिए:

1. Apple App Store या Google Play Store में, Fitbit मोबाइल ऐप्लिकेशन खोजें और उसे डाउनलोड करें.
2. ऐप्लिकेशन का आइकॉन चुनें.
3. Sign in with Google पर क्लिक करें.
4. अपना Google खाता चुनें और जारी रखें बटन दबाएं.

2. Google Cloud प्रोजेक्ट सेट अप करना

Google Cloud console का इस्तेमाल करके, क्लाइंट आईडी बनाया जाएगा. साथ ही, Google Health API का इस्तेमाल करने की सुविधा चालू की जाएगी.

1. Google Cloud Console में साइन इन करें.
2. नया प्रोजेक्ट बनाने के लिए:
   1. प्रोजेक्ट पिकर में जाकर, कोई प्रोजेक्ट चुनें पर क्लिक करें.
   2. सबसे ऊपर दाएं कोने में, नया प्रोजेक्ट को चुनें.
   3. अपने प्रोजेक्ट का नाम डालें.
   4. अपनी जगह की जानकारी डालें. उदाहरण के लिए, "कोई संगठन नहीं".
   5. बनाएं बटन पर क्लिक करें.
   6. अपना प्रोजेक्ट चुनें.

Google Health API को चालू करना

1. सबसे ऊपर बाएं कोने में मौजूद, मेन्यू आइकॉन पर क्लिक करें
2. एपीआई और सेवाएं > लाइब्रेरी को चुनें.
3. "Google Health API" खोजें और इसे चालू करें.

OAuth क्रेडेंशियल सेट अप करना

अगर आप Google Cloud Console में नहीं हैं, तो Google Cloud Console पर जाएं.

1. सबसे ऊपर बाएं कोने में मौजूद, मेन्यू आइकॉन पर क्लिक करें
2. एपीआई और सेवाएं > क्रेडेंशियल को चुनें.
3. सबसे ऊपर बीच में मौजूद, + क्रेडेंशियल बनाएं > OAuth क्लाइंट आईडी को चुनें.
4. सहमति वाली स्क्रीन कॉन्फ़िगर करें बटन पर क्लिक करें. अगर आपको "Google Auth Platform को अभी तक कॉन्फ़िगर नहीं किया गया है" मैसेज दिखता है, तो शुरू करें बटन पर क्लिक करें.
5. सेक्शन 1 में:
   1. ऐप्लिकेशन का नाम डालें.
   2. उपयोगकर्ता सहायता केंद्र का ईमेल पता डालें.
   3. आगे बढ़ें बटन पर क्लिक करें.
6. सेक्शन 2 में:
   1. External चुनें.
   2. आगे बढ़ें बटन पर क्लिक करें.
7. सेक्शन 3 में:
   1. संपर्क जानकारी फ़ील्ड में अपना ईमेल पता डालें.
   2. आगे बढ़ें बटन पर क्लिक करें.
8. सेक्शन 4 में:
   1. Google की API सेवाओं की उपयोगकर्ता के डेटा से जुड़ी नीति से सहमत होने के लिए, चेकबॉक्स पर क्लिक करें.
   2. बनाएं बटन पर क्लिक करें.
9. एपीआई और सेवाएं > क्रेडेंशियल पर जाएं. इसके बाद, + क्रेडेंशियल बनाएं > OAuth क्लाइंट आईडी चुनें.
10. ऐप्लिकेशन टाइप वेब ऐप्लिकेशन चुनें.
11. क्लाइंट आईडी नाम डालें.
12. अनुमति वाले JavaScript ऑरिजिन को खाली छोड़ें.
13. अनुमति वाले रीडायरेक्ट यूआरआई में जाकर, + यूआरआई जोड़ें पर क्लिक करें. इसके बाद, ये यूआरआई जोड़ें:
    • https://www.google.com
    • https://developers.google.com/oauthplayground
14. बनाएं बटन पर क्लिक करें.
15. Google Console में एक मैसेज दिखेगा, जिसमें बताया जाएगा कि आपका क्लाइंट आईडी बन गया है. क्लाइंट आईडी और क्लाइंट सीक्रेट डाउनलोड करने के लिए, JSON डाउनलोड करें लिंक पर क्लिक करें या वैल्यू लिख लें. इसके बाद, आपको अपने क्लाइंट का सीक्रेट वापस नहीं मिल पाएगा.
16. ठीक है पर क्लिक करें. आपको "OAuth 2.0 क्लाइंट आईडी" पेज पर वापस भेज दिया जाएगा.
17. आपका क्लाइंट आईडी आपके प्रोजेक्ट में जोड़ दिया जाएगा. जानकारी देखने के लिए, क्लाइंट आईडी यूआरएल पर क्लिक करें.

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

टेस्ट यूज़र जोड़ना

1. बाईं ओर मौजूद पैनल में, ऑडियंस चुनें. आपको "पब्लिश करने का स्टेटस" जांच की जा रही है पर सेट किया हुआ दिखना चाहिए. साथ ही, "उपयोगकर्ता का टाइप" बाहरी पर सेट किया हुआ दिखना चाहिए.
2. "टेस्ट उपयोगकर्ता" सेक्शन में जाकर, + उपयोगकर्ता जोड़ें बटन पर क्लिक करें. उस उपयोगकर्ता का ईमेल पता डालें जिसका डेटा आपको वापस पाना है.
3. सेव करें बटन पर क्लिक करें.

क्लाइंट आईडी में स्कोप जोड़ना

1. बाईं ओर मौजूद पैनल में, डेटा ऐक्सेस को चुनें.
2. स्कोप जोड़ें या हटाएं बटन पर क्लिक करें.
3. एपीआई कॉलम में, "Google Health API" खोजें. इस कोडलैब के लिए, हम .../auth/googlehealth.activity_and_fitness.readonly स्कोप का इस्तेमाल कर रहे हैं
4. स्कोप चुनने के बाद, डेटा ऐक्सेस पेज पर वापस जाने के लिए, अपडेट करें बटन दबाएं.
5. सेव करें बटन पर क्लिक करें.

आपने क्लाइंट आईडी सेट अप कर लिया है.

3. Fitbit के मोबाइल ऐप्लिकेशन में डेटा जोड़ना

Fitbit का इस्तेमाल पहली बार करने वाले लोगों के Fitbit खाते में, क्वेरी करने के लिए डेटा नहीं होता. हम मैन्युअल तरीके से एक कसरत का लॉग जोड़ेंगे. इसके लिए, हम किसी एक एंडपॉइंट का इस्तेमाल करेंगे. एक्सरसाइज़ को मैन्युअल तरीके से रिकॉर्ड करने के लिए, यह तरीका अपनाएं:

1. अपने डिवाइस पर Fitbit का मोबाइल ऐप्लिकेशन खोलें. अगर ज़रूरी हो, तो अपने Fitbit खाते में साइन इन करें.
2. स्क्रीन के सबसे नीचे दाएं कोने में, + बटन पर टैप करें.
3. "मैन्युअल तरीके से लॉग करें" सेक्शन में जाकर, गतिविधि पर टैप करें
4. चलना कसरत का टाइप खोजें और उसे चुनें.
5. आज के लिए, शुरू होने का समय डालें.
6. अवधि को 15 मिनट पर सेट करें.
7. दूरी को 1.6 कि॰मी॰ पर सेट करें.
8. जोड़ें पर टैप करें.
9. स्क्रीन को दबाकर रखें और नीचे की ओर स्लाइड करके, मोबाइल ऐप्लिकेशन को Fitbit सर्वर के साथ सिंक करें. उंगली हटाने पर, आपको मोबाइल ऐप्लिकेशन सिंक होता हुआ दिखेगा.
10. "गतिविधि" सेक्शन में, आपको मैन्युअल तरीके से लॉग की गई पैदल चलने की गतिविधि दिखेगी.

4. OAuth 2.0 Playground में अनुमति देना

OAuth 2.0 Playground पर जाएं.

Google Health API के लिए, यह ज़रूरी है कि आप Playground के साथ अपने OAuth क्रेडेंशियल का इस्तेमाल करें.

1. सबसे ऊपर दाईं ओर मौजूद, OAuth 2.0 कॉन्फ़िगरेशन गियर आइकॉन पर क्लिक करें.
2. अपने OAuth क्रेडेंशियल का इस्तेमाल करें को चुनें.
3. Google Cloud प्रोजेक्ट सेटअप करने के दौरान मिला OAuth क्लाइंट आईडी और OAuth क्लाइंट सीक्रेट डालें.

Playground के इंटरफ़ेस को तीन मुख्य चरणों में बांटा गया है. हम इन चरणों का पालन करेंगे:

1. एपीआई चुनें और उन्हें अनुमति दें
2. टोकन के लिए ऑथराइज़ेशन कोड एक्सचेंज करना
3. एपीआई को अनुरोध भेजना

एपीआई चुनें और उन्हें अनुमति दें

यहां आपको उन एपीआई स्कोप को चुनना होता है जिनके लिए आपको अनुरोध करना है.

1. पहले चरण में, एपीआई की सूची में Google Health API v4 ढूंढें और उसे बड़ा करें.
2. https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly चुनें. अगर आपको जिस स्कोप की ज़रूरत है वह सूची में नहीं दिखता है, तो उसे "अपने स्कोप डालें" फ़ील्ड में मैन्युअल तरीके से डाला जा सकता है.
3. एपीआई को अनुमति दें पर क्लिक करें.
4. Google के OAuth 2.0 ऑथराइज़ेशन एंडपॉइंट को एक अनुरोध भेजा जाता है. इस अनुरोध में चुने गए स्कोप शामिल होते हैं. इसके बाद, आपको Google खाते की सहमति वाली स्क्रीन पर रीडायरेक्ट कर दिया जाता है.
5. अगर आपने पहले से साइन इन नहीं किया है, तो उस टेस्ट उपयोगकर्ता खाते से साइन इन करें जिसे आपने Google Cloud प्रोजेक्ट सेट अप करें सेक्शन में कॉन्फ़िगर किया था.
6. अनुरोध की गई अनुमतियों की समीक्षा करें. इसके बाद, ऐक्सेस देने के लिए जारी रखें पर क्लिक करें.

सहमति देने पर, Google आपको वापस Playground पर रीडायरेक्ट करता है. साथ ही, टूल को अनुमति देने वाला कोड देता है. इसका इस्तेमाल अगले चरण में किया जाता है.

दाईं ओर मौजूद अनुरोध / जवाब पैनल में, एचटीटीपी रीडायरेक्शन का पूरा फ़्लो दिखता है.

अनुमति पाने के शुरुआती अनुरोध का जवाब, 302 Found रीडायरेक्ट है:

HTTP/1.1 302 Found
Location: https://accounts.google.com/o/oauth2/v2/auth?redirect_uri=https%3A%2F%2Fdevelopers.google.com%2Foauthplayground&prompt=consent&response_type=code&client_id=your_client_id&scope=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fgooglehealth.activity_and_fitness.readonly&access_type=offline

इसके बाद, Playground पर रीडायरेक्ट किए गए अनुरोध में ऑथराइज़ेशन कोड शामिल होता है:

GET /oauthplayground/?iss=https://accounts.google.com&code=authorization_code&scope=https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly HTTP/1.1
Host: developers.google.com

अनुमति देने का कोड, अक्षर और अंकों से बनी ऐसी वैल्यू होती है जिसे GET अनुरोध यूआरएल में code= और &scope के बीच authorization_code के तौर पर दिखाया जाता है. इस उदाहरण में, वैल्यू इस तरह की है: 4/0AbPOj...

टोकन के लिए ऑथराइज़ेशन कोड एक्सचेंज करना

इस चरण में, कोड को ऐसे टोकन के लिए बदला जाता है जिनकी मदद से एपीआई अनुरोध किए जा सकते हैं.

एपीआई चुनें और उन्हें अनुमति दें प्रोसेस पूरी होने के बाद, Playground में ऑथराइज़ेशन कोड फ़ील्ड अपने-आप भर जाता है. इसे टोकन के बदले पाने के लिए:

1. दूसरे चरण में, टोकन के लिए ऑथराइज़ेशन कोड बदलें बटन पर क्लिक करें.
2. access_token और refresh_token, दाईं ओर मौजूद Request/Response पैनल में दिखते हैं.

आपको कुछ ऐसा जवाब दिखेगा:

{
  "access_token": "ya29.a0AFH6S....",
  "refresh_token_expires_in": 604799,
  "expires_in": 3599,
  "token_type": "Bearer",
  "scope": "https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly",
  "refresh_token": "1/og..."
}

रीफ़्रेश टोकन के बारे में जानकारी

ऑथराइज़ेशन कोड को एक्सचेंज करने पर, रिस्पॉन्स में refresh_token के साथ-साथ refresh_token भी शामिल हो सकता है.access_token access_token कम समय के लिए उपलब्ध होते हैं. आम तौर पर, इनकी अवधि एक घंटे होती है. access_token की समयसीमा खत्म होने पर, आपको refresh_token का इस्तेमाल करके नया access_token पाना होगा. इसके लिए, उपयोगकर्ता को फिर से साइन इन करने या सहमति देने की ज़रूरत नहीं होगी. ऐसा इसलिए हो सका, क्योंकि हमने अनुमति पाने के अनुरोध में access_type=offline को शामिल किया था.

अगर आपको जवाब में refresh_token नहीं मिलता है, तो इसकी वजह यह हो सकती है कि आपने पहले ही इस ऐप्लिकेशन और स्कोप के लिए सहमति दे दी हो. आम तौर पर, रीफ़्रेश टोकन सिर्फ़ तब जारी किए जाते हैं, जब कोई उपयोगकर्ता पहली बार आपके ऐप्लिकेशन के लिए सहमति देता है. इसके अलावा, जब prompt=consent को अनुमति देने वाले यूआरएल में जोड़ा जाता है, तब भी रीफ़्रेश टोकन जारी किए जाते हैं. ऐसा इसलिए किया जाता है, ताकि सहमति वाली स्क्रीन को बाद की अनुमतियों पर भी दिखाया जा सके.

refresh_token लंबे समय तक मान्य रहता है. हालांकि, अगर इसका इस्तेमाल छह महीने तक नहीं किया जाता है, तो यह खत्म हो सकता है या अमान्य हो सकता है. इसके अलावा, अगर उपयोगकर्ता आपके ऐप्लिकेशन का ऐक्सेस रद्द कर देता है या किसी अन्य वजह से भी ऐसा हो सकता है. आपको refresh_token को सुरक्षित तरीके से सेव करके रखना चाहिए, ताकि आने वाले समय में इसका इस्तेमाल किया जा सके.

5. एपीआई को अनुरोध भेजना

अब Google Health API से अनुरोध करने के लिए, ऐक्सेस टोकन का इस्तेमाल किया जा सकता है. Playground में तीसरे चरण में, अनुरोध यूआरआई, एचटीटीपी अनुरोध का तरीका, हेडर, और अनुरोध की बॉडी तय करके, एचटीटीपी अनुरोध को कॉन्फ़िगर करें.

1. एचटीटीपी मेथड को GET पर सेट करें.
2. अनुरोध यूआरआई को https://health.googleapis.com/v4/users/me/dataTypes/exercise/dataPoints पर सेट करें.
3. अनुरोध भेजें पर क्लिक करें.

जवाब कुछ ऐसा दिखना चाहिए:

{
  "dataPoints": [
    {
      "name": "users/2515055256096816351/dataTypes/exercise/dataPoints/8896720705097069096",
      "dataSource": {
        "recordingMethod": "MANUAL",
        "platform": "FITBIT"
      },
      "exercise": {
        "interval": {
          "startTime": "2026-02-23T13:10:00Z",
          "startUtcOffset": "-18000s",
          "endTime": "2026-02-23T13:25:00Z",
          "endUtcOffset": "-18000s"
        },
        "exerciseType": "WALKING",
        "metricsSummary": {
          "caloriesKcal": 16,
          "distanceMillimiters": 1609344,
          "steps": "2038",
          "averagePaceSecondsPerMeter": 0.55923407301360051,
          "activeZoneMinutes": "0"
        },
        "exerciseMetadata": {},
        "displayName": "Walk",
        "activeDuration": "900s",
        "exerciseEvents": [
          {
            "eventTime": "2026-02-23T13:10:00Z",
            "eventUtcOffset": "-18000s",
            "exerciseEventType": "START"
          },
          {
            "eventTime": "2026-02-23T13:25:00Z",
            "eventUtcOffset": "-18000s",
            "exerciseEventType": "STOP"
          }
        ],
        "updateTime": "2026-02-24T01:19:22.450466Z"
      }
    },
    {
      "name": "users/2515055256096816351/dataTypes/exercise/dataPoints/5870930690409355408",
      "dataSource": {
        "recordingMethod": "MANUAL",
        "platform": "FITBIT"
      },
      "exercise": {
        "interval": {
          "startTime": "2026-02-23T06:00:00Z",
          "startUtcOffset": "-18000s",
          "endTime": "2026-02-23T06:15:00Z",
          "endUtcOffset": "-18000s"
        },
        "exerciseType": "WALKING",
        "metricsSummary": {
          "caloriesKcal": 17,
          "distanceMillimiters": 1609344,
          "steps": "2038",
          "averagePaceSecondsPerMeter": 0.55923407301360051,
          "averageHeartRateBeatsPerMinute": "81",
          "activeZoneMinutes": "0",
          "heartRateZoneDurations": {
            "lightTime": "900s"
          }
        },
        "exerciseMetadata": {},
        "displayName": "Walk",
        "activeDuration": "900s",
        "exerciseEvents": [
          {
            "eventTime": "2026-02-23T06:00:00Z",
            "eventUtcOffset": "-18000s",
            "exerciseEventType": "START"
          },
          {
            "eventTime": "2026-02-23T06:15:00Z",
            "eventUtcOffset": "-18000s",
            "exerciseEventType": "STOP"
          }
        ],
        "updateTime": "2026-02-23T08:29:39.480437Z"
      }
    }
  ],
  "nextPageToken": ""
}

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

https://health.googleapis.com/v4/users/me/dataTypes/exercise/dataPoints?filter=exercise.interval.civil_start_time >= "2026-02-22T00:00:00"

फ़िल्टर किए गए नतीजे देखने के लिए, अनुरोध भेजें पर फिर से क्लिक करें.

6. बधाई हो

बधाई हो!

आपने बुनियादी कोडलैब पूरा कर लिया है. साथ ही, आपने OAuth 2.0 ऑथराइज़ेशन की जांच करने और Google Health API एंडपॉइंट को कॉल करने के लिए, OAuth2 Playground का इस्तेमाल करना सीख लिया है.

हमें उम्मीद है कि आपको Google Health API के साथ इंटिग्रेट होने वाले ऐप्लिकेशन बनाने में मज़ा आएगा. ज़्यादा जानकारी के लिए, रेफ़रंस दस्तावेज़ में Google Health API के अन्य एंडपॉइंट देखें. साथ ही, वेब सर्वर ऐप्लिकेशन के लिए Google OAuth 2.0 के बारे में ज़्यादा जानें.