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

इस दस्तावेज़ में, लेबल से जुड़े ये टास्क करने का तरीका बताया गया है:

  • लेबल बंद करना
  • लेबल चालू करना
  • लेबल मिटाना

लेबल बंद करना

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

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

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

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

  • labels संसाधन, जो लेबल को दिखाता है. इसमें एक name और एक id होता है. जो लेबल के लिए दुनिया भर में यूनीक आइडेंटिफ़ायर होता है.

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

यहां दिए गए कोड सैंपल में, सही लेबल को बंद करने के लिए, लेबल के id का इस्तेमाल करने का तरीका बताया गया है:

Python

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

Node.js

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

बंद किए जाने वाले लेबल के आईडी से, ID को बदलें.

लेबल की State DISABLED होती है. साथ ही, लेबल के वर्शन का आईडी बढ़ जाता है. उपयोगकर्ता, Drive Labels API के ज़रिए लेबल लागू कर सकते हैं. हालांकि, बंद किया गया लेबल, यूज़र इंटरफ़ेस (यूआई) में तब तक नहीं दिखता, जब तक the showInApply फ़ील्ड का DisabledPolicy ऑब्जेक्ट कॉन्फ़िगर न किया गया हो.

लेबल चालू करना

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

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

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

  • labels संसाधन, जो लेबल को दिखाता है. इसमें एक name और एक id होता है. जो लेबल के लिए दुनिया भर में यूनीक आइडेंटिफ़ायर होता है.

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

यहां दिए गए कोड सैंपल में, सही लेबल को चालू करने के लिए, लेबल के id का इस्तेमाल करने का तरीका बताया गया है:

Python

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

Node.js

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

चालू किए जाने वाले लेबल के आईडी से, ID को बदलें.

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

लेबल मिटाना

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

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

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

  • labels संसाधन, जो लेबल को दिखाता है. इसमें एक name और एक id होता है. जो लेबल के लिए दुनिया भर में यूनीक आइडेंटिफ़ायर होता है.

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

यहां दिए गए कोड सैंपल में, सही लेबल को मिटाने के लिए, लेबल के id का इस्तेमाल करने का तरीका बताया गया है:

Python

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

Node.js

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

मिटाए जाने वाले लेबल के आईडी से, ID को बदलें.

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