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

इस दस्तावेज़ में, 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 के स्कोप के बारे में ज़्यादा जानने के लिए, OAuth 2.0 का इस्तेमाल करके, Google API को ऐक्सेस करना लेख पढ़ें.

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