इस दस्तावेज़ में 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 में लगाए गए लेबल मेटाडेटा को पढ़ने, खोजने, और उसमें बदलाव करने के लिए किया जा सकता है:
स्कोप | मतलब |
---|---|
|
Drive में मौजूद आइटम पर लागू किए गए लेबल मेटाडेटा को पढ़ें, खोजें, और उसमें बदलाव करें. |
|
Drive के उन आइटम पर लागू किए गए लेबल का मेटाडेटा पढ़ें और खोजें जिन्हें ऐप्लिकेशन के लिए अनुमति मिली है. |
ज़्यादा जानकारी के लिए, Drive API OAuth 2.0 स्कोप और Drive API से जुड़ी खास अनुमति देखें.
लेबल के दायरे
लेबल देखने और मैनेज करने के लिए, यहां दिए गए OAuth दायरों का इस्तेमाल किया जा सकता है:
स्कोप | मतलब |
---|---|
https://www.googleapis.com/auth/drive.labels
|
Drive के लेबल देखना, इस्तेमाल करना, और उन्हें मैनेज करना.
|
https://www.googleapis.com/auth/drive.labels.readonly
|
Drive के लेबल देखना और उनका इस्तेमाल करना.
|
https://www.googleapis.com/auth/drive.admin.labels
|
आपके संगठन के सभी Drive लेबल देखना, उनमें बदलाव करना, उन्हें बनाना, और मिटाना. साथ ही, संगठन के लेबल से जुड़ी एडमिन की नीतियां देखना.
|
https://www.googleapis.com/auth/drive.admin.labels.readonly
|
अपने संगठन के सभी Drive लेबल और लेबल से जुड़ी एडमिन नीतियां देखें.
|
एडमिन ऐक्सेस
ADMIN
लेबल मैनेज करने के लिए, आपको यह जानकारी देनी होगी:
- उपयोगकर्ता के एडमिन क्रेडेंशियल का इस्तेमाल करने के लिए,
useAdminAccess
true
है. - लेबल मैनेज करें खास अधिकार वाले खाता एडमिन.
useAdminAccess
एडमिन को अपने खास अधिकार शुरू करने के लिए, useAdminAccess
पैरामीटर सेट करना होगा. useAdminAccess
को सेट करने पर, ग्राहक के मालिकाना हक वाले किसी भी लेबल को देखा और उसमें बदलाव किया जा सकता है. इसमें ADMIN
और SHARED
, दोनों लेबल शामिल हैं.
अगर useAdminAccess
को सेट नहीं किया गया है, तो सिर्फ़ SHARED
label type
वाले लेबल और इस लेबल के लिए EDITOR
भूमिका वाले उपयोगकर्ताओं को लिखने का अनुरोध किया जा सकता है.
ज़्यादा जानकारी के लिए, ऐक्सेस क्रेडेंशियल बनाएं देखें.