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

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

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

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

Google Drive Labels API के दायरे

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

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

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

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

दायरा मतलब
  • 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 उचित भूमिका वाले उपयोगकर्ताओं के लिए उपलब्ध है.

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