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

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

लेबल बनाएं

लेबल बनाने के लिए, 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 विकल्प इस्तेमाल किए जा सकते हैं किसी फ़ाइल के लिए ज़्यादा से ज़्यादा 10 विकल्प चुने जा सकते हैं, जैसा कि ListOptions में कॉन्फ़िगर किया गया है
IntegerOptions	कोई संख्या डालें	सिर्फ़ पूर्ण संख्याएं ही इस्तेमाल की जा सकती हैं
DateOptions	कैलेंडर की तारीख चुनें	(ज़रूरी नहीं) Date format को “लंबा: DD, DD, YYYY” या “छोटा महीना: MM/DD/YY“ पर सेट किया जा सकता है
TextOptions	टेक्स्ट बॉक्स में टेक्स्ट डालना	ज़्यादा से ज़्यादा 100 वर्ण इस्तेमाल किए जा सकते हैं
UserOptions	Google Workspace की संपर्क सूची में से एक या उससे ज़्यादा उपयोगकर्ता चुनें.	किसी फ़ाइल के लिए, उपयोगकर्ता के तौर पर ज़्यादा से ज़्यादा 10 एंट्री हो सकती हैं, जैसा कि ListOptions में कॉन्फ़िगर किया गया है

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

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

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