Drive Labels API की खास जानकारी

लेबल ऐसे मेटाडेटा होते हैं जिन्हें तय करके, उपयोगकर्ताओं को Google Drive में मौजूद फ़ाइलों को व्यवस्थित करने, उन्हें ढूंढने, और उन पर नीति लागू करने में मदद मिलती है. Drive label API एक RESTful API है, जो आपकी Drive की फ़ाइलों में मेटाडेटा अटैच करके, कारोबार की प्रोसेस के साथ काम करती है. इस एपीआई के सामान्य इस्तेमाल:

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

  • Drive में मौजूद आइटम पर नीति लागू करें—Drive के कॉन्टेंट को अपनी पूरी लाइफ़साइकल के दौरान मैनेज करने के लिए लेबल बनाएं और पक्का करें कि वह आपके संगठन के रिकॉर्ड रखने के तरीकों का पालन करता हो. उदाहरण के लिए, डेटा लीक होने की नीति (डीएलपी) को मैनेज करने के लिए लेबल इस्तेमाल करें. इसमें "संवेदनशीलता" वाले लेबल वाली "सबसे गोपनीय" पर सेट की गई फ़ाइलों को कंप्यूटर पर डाउनलोड नहीं किया जा सकता.

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

Drive लेबल एपीआई में इस्तेमाल होने वाले सामान्य शब्दों की सूची यहां दी गई है:

लेबल

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

लेबल का नाम
लेबल के संसाधन का नाम. लेबल आईडी, लेबल के नाम का हिस्सा होता है. अनुरोध के आधार पर, नाम इनमें से किसी एक रूप में होता है: labels/{id} या labels/{id}@{revisionId}. ज़्यादा जानकारी के लिए, लेबल में बदलाव करना नीचे देखें.
लेबल आईडी
लेबल के लिए दुनिया भर में लागू होने वाला यूनीक आइडेंटिफ़ायर. यह आईडी, लेबल के नाम का हिस्सा होता है, लेकिन नाम की तरह, बदलाव करने के दौरान भी यह एक जैसा रहता है.

लेबल दो तरह के होते हैं:

बैज वाला लेबल

एक लेबल जिसमें SelectionOptions फ़ील्ड टाइप के विकल्प मौजूद होते हैं. इन विकल्पों की अहमियत बताने के लिए, इन्हें कलर कोड में बदला जा सकता है. ऐसा करने के लिए, Choice के Properties badgeConfig को सेट करें.

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

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

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

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

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

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

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

लेबल का टाइप

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

एडमिन

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

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

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

    • डिस्क आइटम: EDITOR
    • लेबल: APPLIER

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

    • डिस्क आइटम: READER
    • लेबल: READER
शेयर किया गया

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

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

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

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

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

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

लेबल में बदलाव करना

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

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

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

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