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 वाले फ़ील्ड टाइप का लेबल, जिसमें choices शामिल होते हैं. इनकी अहमियत बताने के लिए अलग-अलग कलर कोड इस्तेमाल किए जा सकते हैं. ऐसा करने के लिए, Choice के Properties के ज़रिए badgeConfig को सेट करना होगा.

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

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

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

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

किसी लेबल का टाइप किया जा सकने वाला अलग-अलग कॉम्पोनेंट. किसी लेबल के साथ शून्य या ज़्यादा फ़ील्ड जुड़े हो सकते हैं.

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

उपयोगकर्ता, SelectionOptions फ़ील्ड में मौजूद कई विकल्पों में से कोई एक चुन सकता है.

लेबल टाइप

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

एडमिन

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

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

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

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

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

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

लेबल टेक्सॉनमी

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

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

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

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

लेबल संशोधन

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

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

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