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

इस दस्तावेज़ में, Google Sheets API के लिए अनुमति और पुष्टि करने से जुड़ी जानकारी दी गई है. इस दस्तावेज़ को पढ़ने से पहले, पुष्टि और अनुमति के बारे में जानें पर जाकर, Google Workspace की पुष्टि और अनुमति से जुड़ी सामान्य जानकारी ज़रूर पढ़ें.

ध्यान दें कि Sheets API के स्कोप, स्प्रेडशीट फ़ाइल पर लागू होते हैं. इन्हें किसी खास शीट तक सीमित नहीं किया जा सकता. किसी शीट में बदलाव होने से रोकने के लिए, ProtectedRange का इस्तेमाल करें. इससे किसी सेल या सेल की रेंज को इस तरह से तय किया जा सकता है कि उसमें बदलाव न किया जा सके. उदाहरण के लिए, नाम वाली और सुरक्षित की गई रेंज देखें.

अनुमति देने के लिए 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 API को ऐक्सेस करने की ज़रूरत है, तो उन स्कोप को भी जोड़ा जा सकता है. Google API के स्कोप के बारे में ज़्यादा जानने के लिए, Google API को ऐक्सेस करने के लिए OAuth 2.0 का इस्तेमाल करना लेख पढ़ें.

OAuth 2.0 के कुछ खास स्कोप के बारे में ज़्यादा जानने के लिए, Google APIs के लिए OAuth 2.0 स्कोप देखें.