Drive Labels API की खास जानकारी

लेबल मेटाडेटा होते हैं. इन्हें तय करके, उपयोगकर्ताओं को Google Drive में मौजूद फ़ाइलों को व्यवस्थित करने, ढूंढने, और उन पर नीतियां लागू करने में मदद मिलती है. Drive Labels API, RESTful API है. यह Drive में मौजूद आपकी फ़ाइलों में मेटाडेटा जोड़कर, कारोबार की प्रोसेस को बेहतर बनाता है. इस एपीआई का इस्तेमाल इन कामों के लिए किया जाता है:

  • कॉन्टेंट को कैटगरी में बांटकर, जानकारी के मैनेजमेंट की रणनीति का पालन करना—संवेदनशील कॉन्टेंट या ऐसे डेटा की पहचान करने के लिए लेबल बनाएं जिसे खास तरीके से मैनेज करने की ज़रूरत होती है. उदाहरण के लिए, "संवेदनशीलता" नाम का बैज वाला लेबल (कलर-कोडेड विकल्प वैल्यू वाला लेबल) बनाया जा सकता है. इसकी वैल्यू "अति गोपनीय," "गोपनीय," और "सार्वजनिक" हो सकती हैं.

  • Drive में मौजूद आइटम पर नीति लागू करना— Drive में मौजूद कॉन्टेंट को उसके लाइफ़साइकल के दौरान मैनेज करने के लिए लेबल बनाएं. साथ ही, यह पक्का करें कि यह आपके संगठन के रिकॉर्ड रखने के तरीकों के मुताबिक हो. उदाहरण के लिए, डेटा लीक होने की रोकथाम (डीएलपी) की नीति को मैनेज करने के लिए लेबल का इस्तेमाल करें. इसके तहत, "संवेदनशीलता" लेबल वाली फ़ाइलों को "अति गोपनीय" पर सेट करके, कंप्यूटर पर डाउनलोड नहीं किया जा सकता.

  • फ़ाइलों को व्यवस्थित करना और ढूंढना— अपनी कंपनी के कॉन्टेंट को खोजने की सुविधा बढ़ाने के लिए लेबल बनाएं. इससे आपके संगठन के लोग, लेबल और उनके फ़ील्ड के आधार पर आइटम ढूंढ सकेंगे. उदाहरण के लिए, आपके संगठन का कोई व्यक्ति, Drive में खोज के विकल्पों का इस्तेमाल करके, किसी खास तारीख तक हस्ताक्षर के लिए बाकी सभी कॉन्ट्रैक्ट ढूंढ सकता है.

Drive Labels API में इस्तेमाल होने वाले सामान्य शब्दों की सूची यहां दी गई है:

लेबल

Drive में मौजूद किसी फ़ाइल पर रखा गया स्ट्रक्चर्ड मेटाडेटा. Drive के उपयोगकर्ता, फ़ाइलों के लिए लेबल असाइन कर सकते हैं और लेबल फ़ील्ड की वैल्यू सेट कर सकते हैं. लेबल में ये शामिल होते हैं:

लेबल का नाम
लेबल का रिसॉर्स नेम. लेबल आईडी, लेबल के नाम का हिस्सा होता है. अनुरोध के आधार पर, नाम इस फ़ॉर्मैट में होता है: labels/{id} या labels/{id}@{revisionId}. ज़्यादा जानकारी के लिए, लेबल का वर्शन देखें.
लेबल आईडी
लेबल के लिए, दुनिया भर में यूनीक आइडेंटिफ़ायर. आईडी, लेबल के नाम का हिस्सा होता है. हालांकि, नाम के उलट, यह वर्शन के हिसाब से बदलता नहीं है.

लेबल दो तरह के होते हैं:

बैज वाला लेबल

यह SelectionOptions फ़ील्ड टाइप वाला लेबल होता है. इसमें विकल्प होते हैं. इन्हें अहमियत के हिसाब से कलर-कोड किया जा सकता है . इसके लिए, Choice की Properties के ज़रिए badgeConfig सेट किया जाता है.

Drive, हर फ़ाइल के लिए चुने गए विकल्प का रंग दिखाता है. इससे उपयोगकर्ताओं को फ़ाइल का स्टेटस, कैटगरी वगैरह के बारे में साफ़ तौर पर पता चलता है. उदाहरण के लिए, "संवेदनशीलता" बैज वाले लेबल के लिए, "अति गोपनीय" विकल्प लाल रंग में दिख सकता है. एक समय में सिर्फ़ एक बैज वाला लेबल इस्तेमाल किया जा सकता है.

स्टैंडर्ड लेबल

यह ऐसा लेबल होता है जिसमें शून्य या उससे ज़्यादा फ़ील्ड टाइप शामिल हो सकते हैं. किसी स्टैंडर्ड लेबल का टाइटल हो सकता है. जैसे, "Project Moonshot." इससे प्रोजेक्ट से जुड़ी सभी फ़ाइलों की जानकारी मिलती है. किसी स्टैंडर्ड लेबल में, कई स्ट्रक्चर्ड फ़ील्ड भी हो सकते हैं. उदाहरण के लिए, "कॉन्ट्रैक्ट" टाइटल वाले लेबल में, "कंपनी," "ड्यू डेट," "स्टेटस," और "हस्ताक्षर करने वाले लोग" के फ़ील्ड शामिल हो सकते हैं. हर फ़ील्ड का एक खास टाइप होता है. जैसे, टेक्स्ट, तारीख, चुनने का विकल्प या उपयोगकर्ता.

बैज वाले लेबल का डायग्राम.
पहली इमेज. बैज वाला लेबल
स्टैंडर्ड लेबल वाला डायग्राम.
दूसरी इमेज. स्टैंडर्ड लेबल
फ़ील्ड

यह लेबल का एक ऐसा कॉम्पोनेंट होता है जिसे टाइप किया जा सकता है और सेट किया जा सकता है. किसी लेबल से शून्य या उससे ज़्यादा फ़ील्ड जोड़े जा सकते हैं.

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

SelectionOptions फ़ील्ड में, उपयोगकर्ता के लिए उपलब्ध कई विकल्पों में से एक.

लेबल टाइप

सभी लेबल में LabelType शामिल होता है. लेबल दो तरह के होते हैं:

एडमिन

एडमिन के मालिकाना हक वाले लेबल बनाने और उनमें बदलाव करने के लिए, आपके पास खाता एडमिन की भूमिका होनी चाहिए. साथ ही, आपके पास लेबल मैनेज करने का अधिकार होना चाहिए.

एडमिन, एडमिन लेबल को किसी भी उपयोगकर्ता के साथ शेयर कर सकते हैं. इससे उस उपयोगकर्ता को Drive में मौजूद आइटम पर लेबल देखने और उन्हें लागू करने की अनुमति मिल जाती है. Drive में मौजूद आइटम पर लेबल की वैल्यू में बदलाव करने या उन्हें पढ़ने के लिए, ये अनुमतियां ज़रूरी हैं:

  • बदलाव करना—किसी उपयोगकर्ता को, दिए गए लेबल से जुड़े Drive में मौजूद आइटम के मेटाडेटा में बदलाव करने के लिए, उसके पास अनुमति के ये लेवल होने चाहिए:

    • Drive में मौजूद आइटम: EDITOR
    • लेबल: APPLIER
  • पढ़ना—किसी उपयोगकर्ता को, दिए गए लेबल से जुड़े Drive में मौजूद आइटम के मेटाडेटा को पढ़ने या खोजने के लिए, उसके पास अनुमति के ये लेवल होने चाहिए:

    • Drive में मौजूद आइटम: READER
    • लेबल: READER
शेयर किए गए

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

लेबल की अलग-अलग कैटगरी

फ़िलहाल, कॉन्फ़िगर किए गए लेबल फ़ील्ड, उपयोगकर्ताओं के लिए उपलब्ध हैं. इन्हें Drive में मौजूद फ़ाइलों पर लागू किया जा सकता है. इसे लेबल स्कीमा भी कहा जाता है.

लेबल की अलग-अलग कैटगरी के उदाहरण:

  • संवेदनशीलता—लाल, नारंगी, पीला, हरा
  • स्टेटस—अभी शुरू नहीं किया गया, ड्राफ़्ट, समीक्षा की जा रही है, फ़ाइनल
  • कॉन्टेंट का टाइप—कॉन्ट्रैक्ट, डिज़ाइन डॉक, मॉकअप
  • डिपार्टमेंट—मार्केटिंग, फ़ाइनेंस, मानव संसाधन, सेल्स
लेबल का लाइफ़साइकल

लेबल, लाइफ़साइकल से गुज़रते हैं. इस दौरान, उन्हें बनाया जाता है, पब्लिश किया जाता है, अपडेट किया जाता है वगैरह. किसी लेबल के लाइफ़साइकल के दौरान, उसका लेबल वर्शन बढ़ता जाता है. ज़्यादा जानकारी के लिए, लेबल का लाइफ़साइकल देखें.

लेबल का वर्शन

लेबल का एक इंस्टेंस. जब भी कोई लेबल बनाया जाता है, अपडेट किया जाता है, पब्लिश किया जाता है या उसे बंद किया जाता है, तो लेबल का वर्शन बढ़ता है.

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

  • Labels API का इस्तेमाल करने वाला कोई आसान ऐप्लिकेशन कॉन्फ़िगर और रन करने का तरीका जानने के लिए, Python का क्विकस्टार्ट आज़माएं.