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

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

लेबल बनाएं

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

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

• एक LabelType.

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

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

इस उदाहरण में, एक स्टैंडर्ड, एडमिन लेबल बनाया गया है. इसमें एक तय टाइटल और एक SelectionOptions Field है जिसमें 2 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

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

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

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

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 में बदलाव करना.
  • फ़ील्ड की पुष्टि करने के विकल्पों में किए गए अपडेट की वजह से, पहले स्वीकार की गई कोई चीज़ अस्वीकार हो जाती है.
  • ज़्यादा से ज़्यादा प्रविष्टियों की संख्या कम करना.