Method: labels.publish

ड्राफ़्ट के सभी बदलावों को लेबल में पब्लिश करें. पब्लिश होने के बाद, हो सकता है कि लेबल फिर से ड्राफ़्ट की स्थिति में न दिखे. ज़्यादा जानकारी के लिए, google.apps.drive.labels.v2.Lifecycle पर जाएं.

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

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

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

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

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

पाथ पैरामीटर

पैरामीटर
name

string

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

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

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

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

boolean

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

object (WriteControl)

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

string

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

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

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

अनुमति के दायरे

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

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

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