लेबल अपडेट करना

अपडेट करने के अनुरोधों का सेट लागू करके, एक लेबल को अपडेट किया जा सकता है. ऐसा करने पर नया ड्राफ़्ट वर्शन चुनें. उदाहरण के लिए, आप किसी मौजूदा लेबल को अपडेट कर सकते हैं और प्रॉपर्टी (लेबल वर्णन) या आप एक नया Field लेबल में जोड़ा जा सकता है.

लेबल अपडेट बैच अपडेट के रूप में काम करता है, क्योंकि यह तरीका अपडेट की सूची लेता है Request ऑब्जेक्ट. यह बैच अनुरोध में बताए गए क्रम के मुताबिक अपडेट करता है. कॉन्टेंट बनाने बैच अपडेट में होने वाले अपडेट अपने आप लागू हो जाते हैं. इसका मतलब है कि अगर बैच विफल रहा, फिर पूरा अपडेट विफल रहा और इनमें से कोई भी नहीं (संभावित रूप से निर्भर) बदलाव लागू किए जाते हैं. लेबल में कोई बदलाव नहीं किया गया है.

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

लेबल ऑब्जेक्ट अपडेट करें

लेबल में ऐसे कई ऑब्जेक्ट शामिल होते हैं जिन्हें अपडेट किया जा सकता है, जैसे कि:

  • लेबल की प्रॉपर्टी
  • फ़ील्ड और फ़ील्ड प्रकार
  • चुनने के विकल्प और चुनने के विकल्प की प्रॉपर्टी

ये कुछ ऐसे ऑब्जेक्ट हैं जो ऑब्जेक्ट के दिखने और काम करने के तरीके को कंट्रोल करते हैं लेबल जोड़ें.

कारोबार किस तरह का है

नीचे दी गई कार्रवाइयां, labels.delta का तरीका जिन्हें नीचे दी गई बड़ी कैटगरी में बांटा गया है:

कैटगरी ब्यौरा
बनाएंऑब्जेक्ट जोड़ें.
अपडेट करेंकिसी ऑब्जेक्ट की कुछ प्रॉपर्टी अपडेट करें.
चालू करेंऑब्जेक्ट चालू करें.
बंद करेंऑब्जेक्ट बंद करें.
मिटाएंऑब्जेक्ट हटाएं.

अगले सेक्शन में, इन कैटगरी का इस्तेमाल यह बताने के लिए किया गया है कि खास कार्रवाइयों के लिए किया जा सकता है.

अपडेट के अनुरोध

labels.delta तरीका काम करता है एक या उससे ज़्यादा प्रॉम्प्ट ऑब्जेक्ट का अनुरोध करें जो करने के लिए एक तरह के अनुरोध के बारे में बताता है. इसके अलावा, कई तरह के किस तरह के अनुरोध हैं. यहां अनुरोधों को अलग-अलग कैटगरी में बांटा गया है अलग-अलग कैटगरी के हिसाब से विज्ञापन दिखाता है.

अनुरोध का टाइप
लेबल प्रॉपर्टी
अपडेट करें UpdateLabelPropertiesRequest
फ़ील्ड
बनाएं CreateFieldRequest
अपडेट करें UpdateFieldPropertiesRequest
UpdateFieldTypeRequest
चालू करें EnableFieldRequest
बंद करें DisableFieldRequest
मिटाएं DeleteFieldRequest
चुनने का विकल्प
बनाएं CreateSelectionChoiceRequest
अपडेट करें UpdateSelectionChoicePropertiesRequest
चालू करें EnableSelectionChoiceRequest
बंद करें DisableSelectionChoiceRequest
मिटाएं DeleteSelectionChoiceRequest

फ़ील्ड मास्क

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

उदाहरण

लेबल अपडेट करने के लिए, delta तरीका labels संग्रह.

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

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

  • एक Request लेबल पर लागू होने वाले अपडेट के बारे में बताता है.

  • एक लेबल title property तरीका.

  • एक या एक से ज़्यादा Field.

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

  • LabelView है LABEL_VIEW_FULL को लेबल करके, लेबल के जवाबों पर लागू किए गए संसाधन व्यू को सेट करें. LABEL_VIEW_FULL सभी संभावित फ़ील्ड दिखाता है.

इस उदाहरण में, सही लेबल को अपडेट करने के लिए, ID का इस्तेमाल किया गया है.

Python

body = {
'use_admin_access': True,
'requests': [{
  'update_label': {
    'properties': {
      'title': 'TITLE'
    },
    'update_mask': {
      'paths': ['title']
    }
  },
}, {
  'create_field': {
    'field': {
      'properties': {
        'display_name': 'DISPLAY_NAME'
      },
      'text_options': {}
    }
  }
}],
'view': 'LABEL_VIEW_FULL'
}
response = service.labels().delta(
  body=body,
  name='labels/ID').execute()

Node.js

var body = {
  'use_admin_access': true,
  'requests': [{
    'update_label': {
      'properties': {
        'title': 'TITLE'
      },
      'update_mask': {
        'paths': ['title']
      }
    },
  }, {
    'create_field': {
      'field': {
        'properties': {
          'display_name': 'DISPLAY_NAME'
        },
        'text_options': {}
      }
    }
  }],
  'view': 'LABEL_VIEW_FULL'
};
service.labels.delta({
  'resource': body,
  'name': 'labels/ID'
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

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