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

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