Google Sheets API के दायरे चुनें

इस दस्तावेज़ में 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 के स्कोप देखें.