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 की भूमिका हो.

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