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, हर फ़ाइल के लिए चुने गए विकल्प का रंग दिखाता है. इससे उपयोगकर्ताओं को फ़ाइल का स्टेटस, कैटगरी वगैरह के बारे में साफ़ तौर पर पता चलता है. उदाहरण के लिए, "संवेदनशीलता" बैज वाले लेबल के लिए, "सबसे ज़्यादा गोपनीय" विकल्प लाल रंग में दिख सकता है. एक समय में सिर्फ़ एक बैज वाला लेबल इस्तेमाल किया जा सकता है.

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

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

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

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

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

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

लेबल टाइप

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

एडमिन

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

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

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

    • Drive में मौजूद आइटम: EDITOR
    • लेबल: APPLIER

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

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

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

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

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

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

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

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

लेबल का वर्शन

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

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