Google Health API, उपयोगकर्ता के डेटा के ऐक्सेस और सुरक्षा को मैनेज करने के लिए, एक मज़बूत और स्टैंडर्ड फ़्रेमवर्क का इस्तेमाल करता है. इस बदलाव का एक अहम हिस्सा, Fitbit के पुराने ऑथराइज़ेशन (एफ़ओटी) से Google OAuth 2.0 पर स्विच करना है. इस बदलाव से डेवलपर, Google की स्टैंडर्ड ऑथेंटिकेशन लाइब्रेरी का फ़ायदा ले सकते हैं. इससे, लागू करने की प्रोसेस आसान हो जाती है. साथ ही, उपयोगकर्ताओं को अपनी अनुमतियां मैनेज करने के लिए, एक जाना-पहचाना और सेंट्रलाइज़्ड इंटरफ़ेस मिलता है.
ऐप्लिकेशन रजिस्ट्रेशन
Google Health API का इस्तेमाल करने वाले सभी ऐप्लिकेशन, Google Cloud Console का इस्तेमाल करके रजिस्टर किए जाने चाहिए. यह आपके सभी Google ऐप्लिकेशन को मैनेज करने के लिए, एक सेंट्रल हब के तौर पर काम करता है.
अपने ऐप्लिकेशन को रजिस्टर करने के लिए, शुरू करना में दिया गया तरीका अपनाएं. अपने ऐप्लिकेशन रजिस्टर करते समय, आपको ये अंतर दिखेंगे.
| Fitbit Web API | Google Health API | |
| सार्वजनिक लिंक | https://dev.fitbit.com/apps | https://console.cloud.google.com |
| नया ऐप्लिकेशन जोड़ना | नया ऐप्लिकेशन रजिस्टर करें को दबाएं |
|
| बुनियादी जानकारी | ये फ़ील्ड भरने होंगे:
|
ये फ़ील्ड भरने होंगे:
|
| ऐप्लिकेशन के टाइप | डेवलपर को इनमें से कोई एक विकल्प चुनना होगा:
|
|
| क्लाइंट आईडी | ऐप्लिकेशन की सेटिंग सेव होने पर रजिस्टर किया गया | अलग-अलग रजिस्टर किया गया |
| ऐक्सेस का प्रकार | डेटा को ऐक्सेस करने और उसमें बदलाव करने की अनुमति, ऐप्लिकेशन के लेवल पर कंट्रोल की जाती है | रीड और राइट ऐक्सेस को स्कोप लेवल पर कंट्रोल किया जाता है |
| अतिरिक्त यूआरएल |
|
|
OAuth लागू करना
Google Health API वाले ऐप्लिकेशन, सिर्फ़ Google OAuth2 क्लाइंट लाइब्रेरी के साथ काम करते हैं. क्लाइंट लाइब्रेरी, लोकप्रिय फ़्रेमवर्क के लिए उपलब्ध हैं. इससे OAuth 2.0 को लागू करना आसान हो जाता है.
Google OAuth2 लाइब्रेरी और ओपन सोर्स OAuth2 लाइब्रेरी के बीच ये अंतर हैं:
| Fitbit Web API | Google Health API | |
| OAuth2 लाइब्रेरी के लिए सहायता | ओपन सोर्स | Google OAuth2 क्लाइंट लाइब्रेरी |
| सुविधा | अलग-अलग प्लैटफ़ॉर्म पर अलग-अलग जानकारी | सभी प्लैटफ़ॉर्म पर एक जैसा अनुभव |
| अनुमति देने के लिए यूआरएल | https://www.fitbit.com/oauth2/authorize | https://accounts.google.com/o/oauth2/v2/auth |
| टोकन यूआरएल | https://api.fitbit.com/oauth2/token | https://oauth2.googleapis.com/token |
| ऐक्सेस टोकन की समयसीमा | 8 घंटे | 1 घंटा |
| ऐक्सेस टोकन का साइज़ | 1024 बाइट | 2048 बाइट |
| Refresh Token | रीफ़्रेश टोकन तब जनरेट होते हैं, जब ऑथराइज़ेशन कोड ग्रांट फ़्लो का इस्तेमाल किया जाता है. किसी उपयोगकर्ता के लिए सिर्फ़ एक रीफ़्रेश टोकन जनरेट किया जा सकता है. टोकन कभी भी समयसीमा खत्म नहीं होते और इनका इस्तेमाल सिर्फ़ एक बार किया जा सकता है. | रीफ़्रेश टोकन जनरेट करने के लिए, अनुमति देने वाली स्ट्रिंग में क्वेरी पैरामीटर "access_type=offline" शामिल होना चाहिए. एक उपयोगकर्ता के लिए, कई रीफ़्रेश टोकन बनाए जा सकते हैं. रीफ़्रेश टोकन, समय के हिसाब से सेट किए जा सकते हैं. अगर छह महीने तक इनका इस्तेमाल नहीं किया जाता है, तो ये क्रेडेंशियल एक्सपायर हो जाएंगे. इसके अलावा, अगर उपयोगकर्ता ने समय के हिसाब से ऐक्सेस दिया है या ऐप्लिकेशन "टेस्टिंग" मोड में है, तो भी ये क्रेडेंशियल एक्सपायर हो जाएंगे. ज़्यादा जानकारी के लिए, रिफ़्रेश टोकन की समयसीमा खत्म होने की जानकारी देखें. |
| टोकन रिस्पॉन्स | JSON रिस्पॉन्स में ये शामिल होते हैं:
|
JSON रिस्पॉन्स में ये शामिल होते हैं:
यूज़र आईडी पाने के लिए, users.getIdentity एंडपॉइंट को कॉल करें. ऐसा तब करें, जब Google Health के कम से कम एक स्कोप को अनुमति मिल जाए. साथ ही, Fitbit के लेगसी टोकन को तब तक चालू रखें, जब तक legacyUserId की पुष्टि नहीं हो जाती.
|
उपयोगकर्ता की फिर से पुष्टि करना (फिर से सहमति लेना ज़रूरी है)
Fitbit के उपयोगकर्ताओं को आपके नए इंटिग्रेशन के लिए फिर से सहमति देनी होगी, क्योंकि आपका ऐप्लिकेशन किसी दूसरी OAuth लाइब्रेरी का इस्तेमाल कर रहा है. ऐक्सेस टोकन और रीफ़्रेश टोकन को Google Health API में ट्रांसफ़र नहीं किया जा सकता. साथ ही, ये टोकन Google Health API में काम नहीं करते.
फिर से सहमति देने वाले हर उपयोगकर्ता को, आपके Google Cloud प्रोजेक्ट के OAuth टोकन की अनुमति देने की दर की सीमा में गिना जाता है. Google Cloud, OAuth टोकन के इस्तेमाल की अनुमति देने की दर को सीमित करता है. इससे यह कंट्रोल किया जाता है कि आपका ऐप्लिकेशन कितनी तेज़ी से उपयोगकर्ताओं को शामिल कर सकता है या उनकी फिर से पुष्टि कर सकता है. अगर आपको लगता है कि 24 घंटे की समयावधि में, 10,000 से ज़्यादा उपयोगकर्ता साइन-अप करेंगे या फिर से पुष्टि करेंगे, तो पहले से ही ज़्यादा कोटा का अनुरोध करें. ज़्यादा जानकारी के लिए, OAuth ऐप्लिकेशन के लिए अनुरोध संख्या सीमित करना लेख पढ़ें.