लेबल को बंद करना, चालू करना और मिटाना

इस पेज पर, लेबल से जुड़े इन टास्क को पूरा करने का तरीका बताया गया है:

  • किसी लेबल को बंद करना
  • किसी लेबल को चालू करना
  • लेबल मिटाएं

किसी लेबल को बंद करना

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

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

पब्लिश किए गए लेबल को बंद करने के लिए, labels कलेक्शन पर disable तरीके का इस्तेमाल करें.

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

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

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

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

Python

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

Node.js

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

लेबल में State DISABLED है और लेबल का रीविज़न आईडी बढ़ गया है. उपयोगकर्ता, एपीआई के ज़रिए लेबल लगा सकते हैं. हालांकि, बंद किए गए लेबल को यूज़र इंटरफ़ेस में तब तक नहीं दिखाया जाता, जब तक कि disabledPolicy तरीके की showInApply प्रॉपर्टी कॉन्फ़िगर न की गई हो.

किसी लेबल को चालू करना

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

बंद किए गए लेबल को चालू करने के लिए, enable तरीके का इस्तेमाल करें.

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

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

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

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

Python

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

Node.js

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

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

लेबल मिटाएं

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

किसी लेबल को मिटाने के लिए, आपको पहले उसे बंद करना होगा. इसके बाद, delete तरीके का इस्तेमाल करें.

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

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

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

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

Python

response = service.labels().delete(
  name='labels/ID',
  useAdminAccess=True).execute()

Node.js

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

लेबल में State DELETED है और लेबल का रीविज़न आईडी बढ़ गया है. लेबल लागू नहीं किया जा सकता. साथ ही, मिटाए गए लेबल आखिर में हटा दिए जाते हैं. ज़्यादा जानकारी के लिए, लेबल का लाइफ़साइकल देखें.