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

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

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

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

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

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

पब्लिश किए गए किसी लेबल को बंद करने के लिए, 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);
});

लेबल में DISABLED का State है और लेबल का रीविज़न आईडी बढ़ जाता है. उपयोगकर्ता, एपीआई के ज़रिए लेबल लागू कर सकते हैं. हालांकि, बंद किए गए लेबल को यूज़र इंटरफ़ेस में तब तक नहीं दिखाया जाता, जब तक कि 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);
});

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

लेबल मिटाएं

सिर्फ़ ड्राफ़्ट और बंद किए गए लेबल मिटाए जा सकते हैं. किसी लेबल को मिटाने पर, उसे पहले जिन जगहों पर लागू किया गया था उन सभी जगहों से वह हमेशा के लिए मिट जाता है. साथ ही, 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);
});

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