OAuth 2.0 के लिए अनुमति लागू करना

YouTube Reporting API और YouTube Analytics API, उपयोगकर्ता के निजी डेटा का ऐक्सेस देने के लिए OAuth 2.0 प्रोटोकॉल का इस्तेमाल करते हैं. यहां दी गई सूची में, OAuth 2.0 के कुछ मुख्य कॉन्सेप्ट के बारे में बताया गया है:

  • जब कोई उपयोगकर्ता आपके ऐप्लिकेशन में ऐसी सुविधाओं का इस्तेमाल करने की कोशिश करता है जिनके लिए उसे Google Account or YouTube account में लॉग इन करना होता है, तब आपका ऐप्लिकेशन OAuth 2.0 की अनुमति पाने की प्रोसेस शुरू करता है.

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

  • अगर उपयोगकर्ता, आपके ऐप्लिकेशन को उन संसाधनों को ऐक्सेस करने की अनुमति देता है, तो Google आपके ऐप्लिकेशन को एक टोकन भेजता है. आपके ऐप्लिकेशन के टाइप के आधार पर, यह टोकन की पुष्टि करता है या इसे किसी दूसरे टाइप के टोकन के लिए बदलता है.

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

अहम जानकारी: OAuth 2.0 ऑथराइज़ेशन का इस्तेमाल करने के लिए, आपको Google API Console में ऑथराइज़ेशन क्रेडेंशियल पाने होंगे.

ज़्यादा जानकारी के लिए, OAuth 2.0 ऑथराइज़ेशन गाइड देखें.

OAuth 2.0 फ़्लो

Google APIs, OAuth 2.0 के इस्तेमाल के कई उदाहरणों के साथ काम करते हैं:

  • सर्वर-साइड वेब ऐप्लिकेशन फ़्लो, ऐसे वेब ऐप्लिकेशन के साथ काम करता है जो लगातार जानकारी को सुरक्षित तरीके से सेव कर सकते हैं.
  • JavaScript वेब ऐप्लिकेशन फ़्लो, ब्राउज़र में चलने वाले JavaScript ऐप्लिकेशन के साथ काम करता है.
  • मोबाइल और डेस्कटॉप ऐप्लिकेशन के फ़्लो में, फ़ोन या कंप्यूटर जैसे किसी डिवाइस पर इंस्टॉल किए गए ऐप्लिकेशन काम करते हैं.
  • टीवी और सीमित इनपुट डिवाइसों के लिए OAuth 2.0 फ़्लो, सीमित इनपुट क्षमताओं वाले डिवाइसों के साथ काम करता है. जैसे, गेम कंसोल और वीडियो कैमरे. The YouTube Reporting and YouTube Analytics APIs do not currently support the OAuth 2.0 flow for devices.
  • सेवा खाते के फ़्लो के लिए OAuth 2.0 फ़्लो, सर्वर-टू-सर्वर इंटरैक्शन के साथ काम करता है. इससे उपयोगकर्ता की जानकारी ऐक्सेस नहीं की जाती. हालांकि, YouTube Reporting API और YouTube Analytics API इस फ़्लो के साथ काम नहीं करते. Since there is no way to link a Service Account to a YouTube account, attempts to authorize requests with this flow will generate an error.

ऐक्सेस स्कोप की पहचान करना

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

OAuth 2.0 ऑथराइज़ेशन लागू करने से पहले, हमारा सुझाव है कि आप उन स्कोप की पहचान करें जिनके लिए आपके ऐप्लिकेशन को ऐक्सेस करने की अनुमति चाहिए होगी.

YouTube Analytics API इन स्कोप का इस्तेमाल करता है:

दायरा ब्यौरा
https://www.googleapis.com/auth/youtube अपना YouTube खाता मैनेज करें
https://www.googleapis.com/auth/youtube.readonly अपना YouTube खाता देखें
https://www.googleapis.com/auth/youtubepartner YouTube पर अपनी परिसंपत्ति और संबंधित सामग्री देखें व प्रबंधित करें
https://www.googleapis.com/auth/yt-analytics-monetary.readonly अपनी YouTube सामग्री के लिए मौद्रिक और गैर-मौद्रिक YouTube Analytics रिपोर्ट देखना
https://www.googleapis.com/auth/yt-analytics.readonly अपनी YouTube सामग्री के लिए YouTube Analytics रिपोर्ट देखें

YouTube Reporting API, इन स्कोप का इस्तेमाल करता है:

दायरा ब्यौरा
https://www.googleapis.com/auth/yt-analytics-monetary.readonly अपनी YouTube सामग्री के लिए मौद्रिक और गैर-मौद्रिक YouTube Analytics रिपोर्ट देखना
https://www.googleapis.com/auth/yt-analytics.readonly अपनी YouTube सामग्री के लिए YouTube Analytics रिपोर्ट देखें

OAuth 2.0 API स्कोप दस्तावेज़ में, उन सभी स्कोप की पूरी सूची दी गई है जिनका इस्तेमाल करके, Google API को ऐक्सेस किया जा सकता है.