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 आइटम पर लागू होने वाली मान्य वैल्यू और खोज क्वेरी के लिए उपलब्ध विकल्पों, दोनों पर पड़ता है.
Choice

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

लेबल का टाइप

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

एडमिन

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

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

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

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

    • Drive आइटम: READER
    • लेबल: READER
शेयर किए गए

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

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

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

लेबल टैक्सोनॉमी के उदाहरण:

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

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

लेबल में बदलाव

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

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

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