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

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

लेबल बनाएं

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