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