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

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

अनुमति के लिए OAuth 2.0 को कॉन्फ़िगर करना

OAuth के लिए सहमति की स्क्रीन को कॉन्फ़िगर करें और दायरे चुनें इससे यह तय किया जा सकेगा कि उपयोगकर्ताओं और ऐप्लिकेशन की समीक्षा करने वालों को कौनसी जानकारी दिखेगी. साथ ही, अपने ऐप्लिकेशन को रजिस्टर करें ताकि उसे बाद में पब्लिश किया जा सके.

Slides API के दायरे

अपने ऐप्लिकेशन को दिए गए ऐक्सेस के लेवल के बारे में बताने के लिए, आपको अनुमति के दायरे की पहचान करनी होगी और उन्हें घोषित करना होगा. अनुमति का दायरा, OAuth 2.0 यूआरआई स्ट्रिंग होता है. इसमें Google Workspace ऐप्लिकेशन का नाम, यह किस तरह का डेटा ऐक्सेस करता है, और ऐक्सेस का लेवल शामिल होता है. दायरे, Google Workspace के डेटा के साथ काम करने के लिए, आपके ऐप्लिकेशन के अनुरोध होते हैं. इनमें, उपयोगकर्ताओं के Google खाते में मौजूद डेटा भी शामिल होता है.

जब आपका ऐप्लिकेशन इंस्टॉल किया जाता है, तो उपयोगकर्ता से ऐप्लिकेशन के इस्तेमाल किए गए दायरों की पुष्टि करने के लिए कहा जाता है. आम तौर पर, आपको सबसे सीमित दायरा चुनना चाहिए और उन दायरों के लिए अनुरोध नहीं करना चाहिए जिनकी आपके ऐप्लिकेशन को ज़रूरत नहीं है. उपयोगकर्ता, सीमित और साफ़ तौर पर बताए गए दायरों को आसानी से ऐक्सेस करने की अनुमति दे देते हैं.

हमारा सुझाव है कि जहां तक हो सके, संवेदनशील दायरों का इस्तेमाल न करें. इससे, हर फ़ाइल के लिए ऐक्सेस का दायरा तय किया जा सकता है. साथ ही, ऐक्सेस को उन खास सुविधाओं तक सीमित किया जा सकता है जिनकी किसी ऐप्लिकेशन को ज़रूरत होती है.

Slides API इन दायरों के साथ काम करता है:

दायरे का कोड ब्यौरा इस्तेमाल
https://www.googleapis.com/auth/presentations Google Slides के अपने सभी प्रज़ेंटेशन देखना, उनमें बदलाव करना, नए प्रज़ेंटेशन बनाना, और पुराने प्रज़ेंटेशन मिटाना. संवेदनशील
https://www.googleapis.com/auth/presentations.readonly Google Slides के अपने सभी प्रज़ेंटेशन देखना. संवेदनशील
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 API के दायरों के बारे में ज़्यादा जानने के लिए, Google के एपीआई ऐक्सेस करने के लिए OAuth 2.0 का इस्तेमाल करना लेख पढ़ें.

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