Google Drive Labels API के स्कोप चुनें

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

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

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

Google Drive Labels API के दायरे

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

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

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

Drive के आइटम पर लागू किए गए लेबल के मेटाडेटा को पढ़ने, खोजने, और उसमें बदलाव करने के लिए, OAuth 2.0 के इन दायरों का इस्तेमाल किया जा सकता है:

दायरा मतलब
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
Drive के आइटम पर लागू किए गए लेबल के मेटाडेटा को पढ़ना, खोजना, और उसमें बदलाव करना.
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive.metadata.readonly
ऐप्लिकेशन के लिए अनुमति वाले Drive के आइटम पर लागू किए गए लेबल के मेटाडेटा को पढ़ना और खोजना.

ज़्यादा जानकारी के लिए, Drive API के OAuth 2.0 के दायरे और Drive API के लिए अनुमति से जुड़ी जानकारी देखें.

लेबल के दायरे

लेबल देखने और मैनेज करने के लिए, OAuth के इन दायरों का इस्तेमाल किया जा सकता है:

दायरा मतलब
https://www.googleapis.com/auth/drive.labels Drive के लेबल देखना, इस्तेमाल करना, और मैनेज करना.
  • इस दायरे से लोगों को ऐक्सेस मिलता है. साथ ही, use_admin_access सेट न होने पर, लिखने की कार्रवाइयों के लिए यह ज़रूरी है.
  • इस दायरे के साथ, लिखने की कार्रवाइयां उन लेबल के लिए मान्य होती हैं जिनका SHARED लेबल टाइप होता है.
https://www.googleapis.com/auth/drive.labels.readonly Drive के लेबल देखना और इस्तेमाल करना.
  • इस दायरे से लोगों को ऐक्सेस मिलता है. साथ ही, use_admin_access सेट न होने पर, पढ़ने की कार्रवाइयों के लिए यह ज़रूरी है.
https://www.googleapis.com/auth/drive.admin.labels आपके संगठन के Drive के सभी लेबल देखना, उनमें बदलाव करना, उन्हें बनाना, और मिटाना. साथ ही, आपके संगठन के लेबल से जुड़ी, एडमिन की नीतियां देखना.
  • इस दायरे से एडमिन को ऐक्सेस मिलता है. साथ ही, use_admin_access सेट होने पर, लिखने की कार्रवाइयों के लिए यह ज़रूरी है. इस दायरे से, पढ़ने का ऐक्सेस भी मिलता है.
  • इस दायरे के साथ, लिखने की कार्रवाइयां उन लेबल के लिए मान्य होती हैं जिनका SHARED या ADMIN लेबल टाइप होता है.
https://www.googleapis.com/auth/drive.admin.labels.readonly आपके संगठन के Drive के सभी लेबल और इनसे जुड़ी, एडमिन की नीतियां देखना.
  • इस दायरे से एडमिन को ऐक्सेस मिलता है. साथ ही, use_admin_access सेट होने पर, पढ़ने की कार्रवाइयों के लिए यह ज़रूरी है.

एडमिन का ऐक्सेस

ADMIN लेबल मैनेज करने के लिए, आपको यह बताना होगा:

  • उपयोगकर्ता के एडमिन क्रेडेंशियल का इस्तेमाल करने के लिए, useAdminAccess को true पर सेट करें.
  • खाते के ऐसे एडमिन जिनके पास लेबल मैनेज करने का अधिकार है.

useAdminAccess

एडमिन को अपने एडमिन के खास अधिकारों का इस्तेमाल करने के लिए, useAdminAccess पैरामीटर सेट करना होगा. useAdminAccess सेट करने से, किसी ग्राहक के पास मौजूद किसी भी लेबल को देखा और उसमें बदलाव किया जा सकता है. इसमें ADMIN और SHARED लेबल, दोनों शामिल हैं.

जब useAdminAccess सेट नहीं होता है, तो लिखने के अनुरोध सिर्फ़ उन लेबल के लिए मान्य होते हैं जिनका SHARED label type होता है. साथ ही, उन लोगों के लिए मान्य होते हैं जिनके पास इस लेबल के लिए, EDITOR की भूमिका होती है.

ज़्यादा जानकारी के लिए, ऐक्सेस क्रेडेंशियल बनाना लेख पढ़ें.