लेबल बनाना और उसे पब्लिश करना

इस पेज पर, लेबल बनाने और उसे पब्लिश करने का तरीका बताया गया है.

लेबल बनाएं

लेबल बनाने के लिए, labels कलेक्शन पर create तरीके का इस्तेमाल करें. लेबल में एक या उससे ज़्यादा Fields शामिल किए जा सकते हैं. हालांकि, ऐसा करना ज़रूरी नहीं है.

आपको यह भी बताना होगा कि:

• LabelType.

• property तरीके का इस्तेमाल करके, title लेबल.

• useAdminAccess को उपयोगकर्ता के एडमिन क्रेडेंशियल इस्तेमाल करने की true है. सर्वर यह पुष्टि करता है कि उपयोगकर्ता, "लेबल मैनेज करें" के अधिकार वाला एडमिन है. इसके बाद ही, उसे ऐक्सेस करने की अनुमति दी जाती है.

इस उदाहरण में, तय किए गए टाइटल और एक SelectionOptions Field के साथ दो Choices वाला स्टैंडर्ड एडमिन लेबल बनाया गया है.

Python

label_body = {
'label_type': 'ADMIN',
'properties': {
    'title': 'TITLE'
},
'fields': [{
    'properties': {
        'display_name': 'DISPLAY_NAME'
    },
    'selection_options': {
        'list_options': {},
        'choices': [{
            'properties': {
                'display_name': 'CHOICE_1'
            }
        }, {
            'properties': {
                'display_name': 'CHOICE_2'
            }
        }]
    }
}]
}
response = service.labels().create(
    body=label_body, useAdminAccess=True).execute()

Node.js

var label = {
'label_type': 'ADMIN',
'properties': {
    'title': 'TITLE'
},
'fields': [{
    'properties': {
    'display_name': 'DISPLAY_NAME'
    },
    'selection_options': {
    'list_options': {},
    'choices': [{
        'properties': {
        'display_name': 'CHOICE_1'
        }
    }, {
        'properties': {
        'display_name': 'CHOICE_2'
        }
    }]
    }
}]
};

service.labels.create({
  'resource': label,
  'use_admin_access': true
}, (err, res) => {
if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

यह लेबल UNPUBLISHED_DRAFT State में बनाया गया है. इसका इस्तेमाल फ़ाइलों पर किया जाना चाहिए और यह लोगों को दिखना चाहिए.PUBLISHED ज़्यादा जानकारी के लिए, लेबल का लाइफ़साइकल देखें.

लेबल की सीमाएं

लेबल बनाने और उन्हें लागू करने के लिए, ये सीमाएं लागू होती हैं:

• स्टैंडर्ड लेबल—150
• हर लेबल के लिए फ़ील्ड—10
• हर फ़ाइल के लिए, उपयोगकर्ता के लागू किए गए लेबल—5

लेबल में फ़ील्ड का इस्तेमाल करना

Field Type	उपयोगकर्ता क्या-क्या कर सकते हैं	फ़ॉर्मैट से जुड़ी बातें और सीमाएं
SelectionOptions	सूची में से एक या उससे ज़्यादा विकल्प चुनें	ज़्यादा से ज़्यादा 200 विकल्प चुने जा सकते हैं ListOptions में कॉन्फ़िगर किए गए फ़ाइल के लिए, ज़्यादा से ज़्यादा 10 विकल्प चुने जा सकते हैं
IntegerOptions	कोई संख्या डालें	सिर्फ़ पूर्ण संख्याएं इस्तेमाल की जा सकती हैं
DateOptions	कैलेंडर में कोई तारीख चुनना	(ज़रूरी नहीं) Date format को “Long: DD Month, YYYY” या “Short: MM/DD/YY“ पर सेट किया जा सकता है
TextOptions	टेक्स्ट बॉक्स में टेक्स्ट डालना	ज़्यादा से ज़्यादा 100 वर्ण इस्तेमाल किए जा सकते हैं
UserOptions	Google Workspace के संपर्कों में से एक या एक से ज़्यादा उपयोगकर्ता चुनें.	ListOptions में कॉन्फ़िगर किए गए फ़ाइल के लिए, उपयोगकर्ता की ज़्यादा से ज़्यादा 10 एंट्री की जा सकती हैं

लेबल पब्लिश करना

Labels API की मदद से, किसी ड्राफ़्ट लेबल को पूरा होने के बाद पब्लिश किया जा सकता है.

किसी लेबल को पब्लिश करने के लिए, publish तरीके का इस्तेमाल करें. साथ ही, यह जानकारी दें:

• यह लेबल रिसॉर्स है, जो हर लेबल को दिखाता है. इसमें एक रिसॉर्स Name और ID होता है. यह लेबल के लिए, दुनिया भर में मान्य यूनीक आइडेंटिफ़ायर (पहचान बताने वाला) होता है.

• useAdminAccess को उपयोगकर्ता के एडमिन क्रेडेंशियल इस्तेमाल करने की true है. सर्वर यह पुष्टि करता है कि उपयोगकर्ता, "लेबल मैनेज करें" के अधिकार वाला एडमिन है. इसके बाद ही, उसे ऐक्सेस करने की अनुमति दी जाती है.

इस उदाहरण में, सही लेबल की पहचान करने और उसे पब्लिश करने के लिए ID का इस्तेमाल किया गया है.

Python

service.labels().publish(
name='labels/ID',
body={
  'use_admin_access': True
}).execute()

Node.js

service.labels.publish({
  'resource': {
    'use_admin_access': true
},
'name': 'labels/ID'
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

लेबल पब्लिश होने के बाद, वह PUBLISHED State में चला जाता है. साथ ही, लेबल के संशोधन का आईडी बढ़ जाता है. इसके बाद, यह लेबल उपयोगकर्ताओं को दिखता है और इसे फ़ाइलों पर लागू किया जा सकता है. ज़्यादा जानकारी के लिए, लेबल का लाइफ़साइकल देखें.

लेबल पब्लिश करते समय आने वाली समस्याएं

• पब्लिश होने के बाद, लेबल को वापस ड्राफ़्ट के तौर पर सेट नहीं किया जा सकता. ज़्यादा जानकारी के लिए, लेबल का लाइफ़साइकल लेख पढ़ें.

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

• पब्लिश करने के बाद, कुछ बदलावों की अनुमति नहीं दी जाती. आम तौर पर, इसका मतलब है कि लेबल से जुड़े मौजूदा मेटाडेटा में ऐसा कोई भी बदलाव अस्वीकार कर दिया जाता है जिससे वह अमान्य हो जाता है या उस पर नई पाबंदियां लग जाती हैं. उदाहरण के लिए, लेबल पब्लिश होने के बाद, लेबल में ये बदलाव नहीं किए जा सकते:

  • लेबल को सीधे तौर पर मिटा दिया जाता है. (इसे पहले बंद करना होगा. इसके बाद, इसे मिटाया जा सकता है.)
  • Field.FieldType बदल गया है.
  • फ़ील्ड की पुष्टि करने के विकल्पों में हुए अपडेट की वजह से, पहले स्वीकार की गई किसी वैल्यू को अस्वीकार कर दिया गया हो.
  • ज़्यादा से ज़्यादा एंट्री की संख्या में कमी.