Google Cloud और OAuth को सेट अप करना

Google Health API का ऐक्सेस, Google Cloud के ज़रिए दिया जाता है. एपीआई चालू करने और Google खाते को अनुमति देने के लिए, आपके पास Google Cloud प्रोजेक्ट होना चाहिए.

अगर आप Fitbit API के मौजूदा डेवलपर हैं या Google Health API का इस्तेमाल पहली बार कर रहे हैं, तो आपको एपीआई को कॉल करने के लिए यह चरण पूरा करना होगा.

प्रोजेक्ट और OAuth क्लाइंट बनाना

एपीआई चालू करें और OAuth 2.0 क्लाइंट आईडी पाएं बटन का इस्तेमाल करके, Google Health API चालू करें और OAuth 2.0 क्लाइंट आईडी पाएं:

1. अगर आपके पास पहले से कोई Google Cloud प्रोजेक्ट है और आपको उसका इस्तेमाल Google Health API के लिए करना है, तो पक्का करें कि आपने उस प्रोजेक्ट के एडमिन खाते में लॉग इन किया हो. इसके बाद, बटन पर क्लिक करके उपलब्ध प्रोजेक्ट की सूची में से मौजूदा प्रोजेक्ट चुनें. अगर ऐसा नहीं है, तो एक नया प्रोजेक्ट बनाएं.
2. जब आपसे पूछा जाए कि "आप कहां से कॉल कर रहे हैं?", तब वेब सर्वर चुनें.
3. रीडाइरेक्ट करने के लिए अनुमति वाले यूआरआई के लिए, https://www.google.com वैल्यू डालें. OAuth 2.0 का इस्तेमाल करके ऑथराइज़ेशन कोड पाने के लिए, रीडायरेक्ट यूआरआई की ज़रूरत होती है.
4. सेटअप पूरा होने के बाद, OAuth 2.0 क्लाइंट आईडी और क्लाइंट सीक्रेट की वैल्यू कॉपी करें. साथ ही, क्रेडेंशियल JSON को अपनी लोकल मशीन पर डाउनलोड करें.

एपीआई चालू करना और OAuth 2.0 क्लाइंट आईडी पाना

अगर आपको Google Cloud प्रोजेक्ट को मैन्युअल तरीके से सेट अप करना है या सेटअप की पुष्टि करनी है और अपने क्रेडेंशियल फिर से पाने हैं, तो:

1. एपीआई चालू करने वाले पेज पर जाकर, Google Health API को चालू करें.
2. क्रेडेंशियल पेज पर जाकर, OAuth 2.0 क्लाइंट आईडी पाएं.

Google कंसोल का इस्तेमाल करके OAuth 2.0 सेट अप करने के बारे में ज़्यादा जानने के लिए, Google API को ऐक्सेस करने के लिए OAuth 2.0 का इस्तेमाल करना लेख पढ़ें.

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

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

ऑडियंस पेज पर जाकर, टेस्ट करने वाले उपयोगकर्ताओं की सूची अपडेट करें:

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

Google Health API का इस्तेमाल 100 से ज़्यादा लोगों के साथ करने के लिए, तीसरे पक्ष की सुरक्षा जांच को पूरा करना ज़रूरी है. ज़्यादा जानकारी के लिए, OAuth ऐप्लिकेशन की पुष्टि करने से जुड़े सहायता केंद्र पर जाएं.

स्कोप जोड़ना

आपको उन स्कोप के बारे में बताना होगा जिन्हें आपका क्लाइंट, डेटा ऐक्सेस पेज पर कॉल कर सकता है:

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

आपने क्लाइंट आईडी सेट अप कर लिया है. अब आपको Google Health API को कॉल करने की सुविधा मिलनी चाहिए.

OAuth2 क्लाइंट लाइब्रेरी

लोकप्रिय फ़्रेमवर्क के साथ इंटिग्रेट करने के लिए इस्तेमाल की जाने वाली, उपलब्ध OAuth2 क्लाइंट लाइब्रेरी की सूची यहां देखी जा सकती है: OAuth 2.0 का इस्तेमाल करके, Google API को ऐक्सेस करना.

रीफ़्रेश टोकन

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

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

अनुरोध

curl -L -X POST 'https://oauth2.googleapis.com/token' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'client_id=client-id&client_secret=client-secret&refresh_token=refresh-token&grant_type=refresh_token'

जवाब

{
  "access_token": "access-token",
  "expires_in": 3599,
  "scope": "scope-list",
  "token_type": "Bearer",
  "refresh_token": "refresh-token",
  "refresh_token_expires_in": 112154
}

जांच के दौरान टोकन का व्यवहार

Google Cloud प्रोजेक्ट के पब्लिशिंग स्टेटस के आधार पर, रीफ़्रेश टोकन के काम करने के तरीके के बारे में जानें:

• टेस्टिंग मोड: अगर OAuth की सहमति वाली स्क्रीन को "टेस्टिंग" पब्लिशिंग स्टेटस के साथ कॉन्फ़िगर किया गया है, तो जारी किए गए रीफ़्रेश टोकन, समय के हिसाब से होते हैं. ये सात दिनों के बाद खत्म हो जाते हैं. इस अवधि के दौरान, आपको एक रीफ़्रेश टोकन मिलेगा. यह टोकन तब तक मान्य रहेगा और इसका इस्तेमाल नए ऐक्सेस टोकन पाने के लिए किया जा सकेगा, जब तक इसकी समयसीमा खत्म नहीं हो जाती.
• पब्लिश किया गया मोड: जब आपका ऐप्लिकेशन "In Production" स्टेटस पर पहुंच जाता है, तो आम तौर पर रीफ़्रेश टोकन की समयसीमा खत्म नहीं होती. ऐसा तब तक होता है, जब तक उन्हें रद्द न कर दिया जाए या वे लंबे समय तक (आम तौर पर छह महीने) इस्तेमाल न किए जाएं.

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