लेबल एक तरह का मेटाडेटा होता है. इसे सेट करने का मकसद, 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 आइटम के मेटाडेटा को पढ़ना या उससे जुड़े किसी लेबल को खोजना है, तो उसके पास अनुमति के सही लेवल होने चाहिए:
- Drive आइटम:
READER - लेबल:
READER
- Drive आइटम:
एडमिन के अलावा अन्य उपयोगकर्ता, शेयर किए गए लेबल बना सकते हैं. इन्हें अन्य लोग, Drive आइटम पर लागू कर सकते हैं. टीमें, एडमिन की ज़रूरत के बिना टीम में इस्तेमाल करने के लिए अपने लेबल बना सकती हैं और उन्हें व्यवस्थित कर सकती हैं.
- लेबल की अलग-अलग कैटगरी
फ़िलहाल, कॉन्फ़िगर किए गए लेबल फ़ील्ड, उपयोगकर्ताओं के लिए उपलब्ध हैं. इन्हें Drive में मौजूद फ़ाइलों पर लागू किया जा सकता है. इसे लेबल स्कीमा भी कहा जाता है.
लेबल टैक्सोनॉमी के उदाहरण:
- संवेदनशीलता—लाल, नारंगी, पीला, हरा
- स्थिति—शुरू नहीं हुआ, ड्राफ़्ट, समीक्षा में है, फ़ाइनल
- कॉन्टेंट का टाइप—कॉन्ट्रैक्ट, डिज़ाइन डॉक, मॉकअप
- डिपार्टमेंट—मार्केटिंग, फ़ाइनेंस, मानव संसाधन, बिक्री
- लेबल का लाइफ़साइकल
लेबल का एक लाइफ़साइकल होता है. इस दौरान, उन्हें बनाया जाता है, पब्लिश किया जाता है, और अपडेट किया जाता है. जैसे-जैसे लेबल लाइफ़साइकल के अलग-अलग चरणों से गुज़रता है वैसे-वैसे उसके लेबल के वर्शन में बढ़ोतरी होती है. ज़्यादा जानकारी के लिए, लेबल का लाइफ़साइकल देखें.
- लेबल में बदलाव
लेबल का एक इंस्टेंस. जब भी कोई लेबल बनाया जाता है, अपडेट किया जाता है, पब्लिश किया जाता है या बंद किया जाता है, तब लेबल के वर्शन में बदलाव होता है.
- ड्राफ़्ट में किया गया बदलाव
- लेबल के मौजूदा ड्राफ़्ट इंस्टेंस का वर्शन नंबर. किसी लेबल में कई अपडेट किए जा सकते हैं. इससे, पब्लिश किए गए वर्शन पर कोई असर नहीं पड़ता. साथ ही, हर अपडेट के साथ ड्राफ़्ट वर्शन का नंबर बढ़ता जाता है. ड्राफ़्ट लेबल की सुविधा की मदद से, लेबल अपडेट को पब्लिश करने से पहले टेस्ट किया जा सकता है.
- पब्लिश किया गया वर्शन
- किसी लेबल के पब्लिश किए गए वर्शन का संशोधन नंबर. पब्लिश किया गया लेबल, लेबल का वह इंस्टेंस होता है जो फ़िलहाल उपयोगकर्ताओं के लिए उपलब्ध है.
मिलते-जुलते विषय
Google Workspace API का इस्तेमाल करके डेवलपमेंट करने के बारे में जानने के लिए, Google Workspace डेवलपर के तौर पर शुरुआत करना लेख पढ़ें. इसमें पुष्टि करने और अनुमति देने की प्रोसेस को मैनेज करने के बारे में भी बताया गया है.
Labels API का इस्तेमाल करके, कोई सामान्य ऐप्लिकेशन कॉन्फ़िगर और चलाने का तरीका जानने के लिए, Python क्विकस्टार्ट आज़माएं.