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