Method: labels.publish

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

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

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

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

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

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

पाथ के पैरामीटर

पैरामीटर
name

string

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

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

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

जेएसओएन के काेड में दिखाना 
{
  "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

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