इस दस्तावेज़ में, Google Docs API के लिए अनुमति और पुष्टि करने से जुड़ी जानकारी दी गई है. इस दस्तावेज़ को पढ़ने से पहले, पुष्टि और अनुमति के बारे में जानें पर जाकर, Google Workspace की पुष्टि और अनुमति से जुड़ी सामान्य जानकारी ज़रूर पढ़ें.
अनुमति देने के लिए OAuth 2.0 को कॉन्फ़िगर करना
OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करें और स्कोप चुनें. इससे यह तय किया जा सकेगा कि उपयोगकर्ताओं और ऐप्लिकेशन की समीक्षा करने वालों को कौनसी जानकारी दिखेगी. साथ ही, अपने ऐप्लिकेशन को रजिस्टर करें, ताकि बाद में उसे पब्लिश किया जा सके.
Docs API के स्कोप
अपने ऐप्लिकेशन को दिए गए ऐक्सेस का लेवल तय करने के लिए, आपको अनुमति के स्कोप की पहचान करनी होगी और उन्हें ज़ाहिर करना होगा. अनुमति का दायरा, OAuth 2.0 यूआरआई स्ट्रिंग होती है. इसमें Google Workspace ऐप्लिकेशन का नाम, ऐक्सेस किए जाने वाले डेटा का टाइप, और ऐक्सेस का लेवल शामिल होता है. स्कोप, Google Workspace डेटा के साथ काम करने के लिए आपके ऐप्लिकेशन के अनुरोध होते हैं. इनमें उपयोगकर्ताओं के Google खाते का डेटा भी शामिल होता है.
जब आपका ऐप्लिकेशन इंस्टॉल किया जाता है, तो उपयोगकर्ता से ऐप्लिकेशन के इस्तेमाल किए गए स्कोप की पुष्टि करने के लिए कहा जाता है. आम तौर पर, आपको सबसे ज़्यादा फ़ोकस वाला स्कोप चुनना चाहिए. साथ ही, ऐसे स्कोप का अनुरोध करने से बचना चाहिए जिनकी आपके ऐप्लिकेशन को ज़रूरत नहीं है. उपयोगकर्ता, सीमित और साफ़ तौर पर बताए गए स्कोप को आसानी से ऐक्सेस दे देते हैं.
हमारा सुझाव है कि जब भी हो सके, तब गैर-संवेदनशील स्कोप का इस्तेमाल करें. इससे हर फ़ाइल के लिए ऐक्सेस स्कोप मिलता है. साथ ही, ऐप्लिकेशन को सिर्फ़ उन सुविधाओं का ऐक्सेस मिलता है जिनकी उसे ज़रूरत होती है.
Docs API इन स्कोप के साथ काम करता है:
| स्कोप कोड | ब्यौरा | इस्तेमाल |
|---|---|---|
https://www.googleapis.com/auth/documents |
Google Docs के आपके सभी दस्तावेज़ देखना, उनमें बदलाव करना, नए दस्तावेज़ बनाना, और पुराने दस्तावेज़ मिटाना. | संवेदनशील |
https://www.googleapis.com/auth/documents.readonly |
Google Docs के आपके सभी दस्तावेज़ देखना. | संवेदनशील |
https://www.googleapis.com/auth/drive.file |
इस ऐप्लिकेशन के साथ, Google Drive की जिन फ़ाइलों का इस्तेमाल किया जाता है उन्हें देखना, बनाना, मिटाना, और उनमें बदलाव करना. | सुझाया गया संवेदनशील नहीं है |
https://www.googleapis.com/auth/drive |
Google Drive में मौजूद अपनी सभी फ़ाइलें देखें, उनमें बदलाव करें, उन्हें बनाएं, और मिटाएं. | सभी देशों/इलाकों में उपलब्ध नहीं है |
https://www.googleapis.com/auth/drive.readonly |
Google Drive में मौजूद अपनी सभी फ़ाइलें देखें और डाउनलोड करें. | सभी देशों/इलाकों में उपलब्ध नहीं है |
टेबल में मौजूद 'इस्तेमाल' कॉलम से पता चलता है कि हर स्कोप कितना संवेदनशील है. यह जानकारी, यहां दी गई परिभाषाओं के हिसाब से दी जाती है:
सामान्य: इन स्कोप से, अनुमति के लिए सबसे कम ऐक्सेस मिलता है. साथ ही, इसके लिए सिर्फ़ ऐप्लिकेशन की बुनियादी पुष्टि की ज़रूरत होती है. इस ज़रूरी शर्त के बारे में जानने के लिए, पुष्टि के लिए अपना ऐप्लिकेशन सबमिट करना लेख पढ़ें.
संवेदनशील: इन स्कोप से, Google पर मौजूद उपयोगकर्ता के ऐसे डेटा का ऐक्सेस मिलता है जिसे उपयोगकर्ता ने आपके ऐप्लिकेशन के लिए अनुमति दी है. इसके लिए, आपको ऐप्लिकेशन की अतिरिक्त पुष्टि करानी होगी. इस ज़रूरी शर्त के बारे में जानकारी पाने के लिए, संवेदनशील और प्रतिबंधित स्कोप से जुड़ी ज़रूरी शर्तें देखें.
पाबंदी वाला: इन स्कोप से, Google के उपयोगकर्ता डेटा का ज़्यादातर हिस्सा ऐक्सेस किया जा सकता है. साथ ही, इनके लिए आपको पाबंदी वाले स्कोप की पुष्टि करने की प्रोसेस पूरी करनी होगी. इस ज़रूरी शर्त के बारे में जानकारी पाने के लिए, Google API सेवाओं की उपयोगकर्ता के डेटा से जुड़ी नीति और एपीआई के कुछ स्कोप के लिए अतिरिक्त ज़रूरी शर्तें देखें. अगर आपको सर्वर पर पाबंदी वाले स्कोप का डेटा सेव करना है या उसे ट्रांसफ़र करना है, तो आपको सुरक्षा जांच करानी होगी.
अगर आपके ऐप्लिकेशन को किसी अन्य Google API को ऐक्सेस करने की ज़रूरत है, तो उन स्कोप को भी जोड़ा जा सकता है. Google API के स्कोप के बारे में ज़्यादा जानने के लिए, Google API को ऐक्सेस करने के लिए OAuth 2.0 का इस्तेमाल करना लेख पढ़ें.
OAuth 2.0 के कुछ खास स्कोप के बारे में ज़्यादा जानने के लिए, Google APIs के लिए OAuth 2.0 स्कोप देखें.
मिलते-जुलते विषय
- Google Drive API के स्कोप चुनना
- OAuth ऐप्लिकेशन की पुष्टि करने से जुड़े सहायता केंद्र पर जाएं
- OAuth ऐप्लिकेशन की पुष्टि से जुड़े अक्सर पूछे जाने वाले सवाल