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 खाते का डेटा भी शामिल होता है.

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

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

नीचे दिए गए 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 भूमिका वाले उपयोगकर्ताओं को लिखने का अनुरोध किया जा सकता है.

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