Method: labels.disable

पब्लिश किए गए लेबल को बंद करें. ज़्यादा जानकारी के लिए, किसी लेबल को बंद करने, चालू करने, और मिटाने का तरीका जानें.

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

लेबल को बंद करने के बाद, labels.delete का इस्तेमाल करके उसे मिटाया जा सकता है.

एचटीटीपी अनुरोध

POST https://drivelabels.googleapis.com/v2/{name=labels/*}:disable

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
name

string

ज़रूरी है. लेबल के संसाधन का नाम.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना
{
  "updateMask": string,
  "useAdminAccess": boolean,
  "writeControl": {
    object (WriteControl)
  },
  "disabledPolicy": {
    object (DisabledPolicy)
  },
  "languageCode": string
}
फ़ील्ड
updateMask

string (FieldMask format)

वे फ़ील्ड जिन्हें अपडेट किया जाना चाहिए. कम से कम एक फ़ील्ड के बारे में बताना ज़रूरी है. रूट disabledPolicy का मतलब है कि इसे तय नहीं किया जाना चाहिए. हर फ़ील्ड को अपडेट करने के लिए, एक * का इस्तेमाल शॉर्ट-हैंड के तौर पर किया जा सकता है.

useAdminAccess

boolean

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

writeControl

object (WriteControl)

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

disabledPolicy

object (DisabledPolicy)

इस्तेमाल के लिए नीति बंद है.

languageCode

string

स्थानीय भाषा में फ़ील्ड के लेबल का आकलन करने के लिए, BCP-47 भाषा कोड का इस्तेमाल करें. अगर भाषा की जानकारी नहीं दी जाती है, तो कॉन्फ़िगर की गई डिफ़ॉल्ट भाषा में मौजूद वैल्यू का इस्तेमाल किया जाएगा.

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में Label का एक इंस्टेंस शामिल किया जाता है.

अनुमति के स्कोप

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.admin.labels

ज़्यादा जानकारी के लिए, अनुमति पाने से जुड़ी गाइड देखें.