इस दस्तावेज़ में, 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 API के लिए OAuth 2.0 स्कोप देखें.
मिलते-जुलते विषय
- Google Drive API के स्कोप चुनना
- OAuth ऐप्लिकेशन की पुष्टि करने से जुड़ा सहायता केंद्र
- OAuth ऐप्लिकेशन की पुष्टि से जुड़े अक्सर पूछे जाने वाले सवाल