अनुरोधों को अनुमति देना

आपका ऐप्लिकेशन फ़िटनेस एपीआई को जो भी अनुरोध भेजता है उसमें अनुमति वाला टोकन होना ज़रूरी है. इस टोकन से Google आपके ऐप्लिकेशन की पहचान भी करता है.

अनुमति देने का प्रोटोकॉल

अनुरोधों को अनुमति देने के लिए, आपके ऐप्लिकेशन में OAuth 2.0 का इस्तेमाल किया जाना चाहिए. अनुमति देने वाले दूसरे प्रोटोकॉल इस्तेमाल नहीं किए जा सकते. अगर आपका ऐप्लिकेशन Google साइन-इन का इस्तेमाल करता है, तो अनुमति की कुछ प्रक्रियाएं Google आपके लिए खुद करता है.

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

OAuth 2.0 से अनुरोधों को अनुमति देना

फ़िटनेस एपीआई की मदद से किए गए सभी अनुरोधों के लिए अनुमति किसी ऐसे उपयोगकर्ता को देनी चाहिए जिसके पास ऐसा करने का अधिकार हो.

OAuth 2.0 के लिए अनुमति देने की प्रक्रिया या "flow," की जानकारी इस बात पर निर्भर करेगी कि आप किस तरह का ऐप्लिकेशन लिख रहे हैं. यह सामान्य प्रक्रिया सभी तरह के ऐप्लिकेशन पर लागू होती है:

1. ऐप्लिकेशन बनाने के बाद उसे Google API कंसोल का इस्तेमाल करके रजिस्टर करें. इसके बाद, Google आपको क्लाइंट आईडी और क्लाइंट सीक्रेट जैसी जानकारी देगा.
2. Google API (एपीआई) कंसोल में फ़िटनेस एपीआई चालू करें. (अगर एपीआई को API (एपीआई) सूची में शामिल नहीं किया गया है, तो यह चरण छोड़ें.)
3. पुष्टि के लिए आवेदन करें और अपने ऐप्लिकेशन में कुछ खास तरह के सवालों के जवाब देने के लिए, काम की जानकारी सबमिट करें. आपके ऐप्लिकेशन को जिन डेटा टाइप को ऐक्सेस करना होगा वह आपके ऐप्लिकेशन के लिए ज़रूरी अनुरोधों के दायरे से मेल खाता होगा.
4. अगर आपके ऐप्लिकेशन की पुष्टि हो गई है, तो उपयोगकर्ता को सहमति देने वाली स्क्रीन दिखाता है. इसमें उपयोगकर्ता से आपके ऐप्लिकेशन को उसका डेटा ऐक्सेस करने की अनुमति देने के लिए कहा जाता है.
5. अगर उपयोगकर्ता इसकी अनुमति दे देता है, तो Google आपके ऐप्लिकेशन को कुछ समय के लिए इस्तेमाल करने का ऐक्सेस देता है.
6. आपका ऐप्लिकेशन, ऐक्सेस टोकन से उपयोगकर्ता के डेटा को ऐक्सेस करने का अनुरोध करता है.
7. अगर Google को पता चलता है कि आपका अनुरोध और टोकन मान्य हैं, तो वह आपके ऐप्लिकेशन को अनुरोध किया गया डेटा दिखाता है.

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

फ़िटनेस एपीआई के OAuth दायरों के बारे में यहां पढ़ें. देखें कि हर तरह के डेटा के लिए कौनसा दायरा ज़रूरी है.