একটি লেবেল আপডেট করুন

আপনি একটি নতুন খসড়া সংশোধনের ফলে আপডেট অনুরোধের একটি সেট প্রয়োগ করে একটি একক লেবেল আপডেট করতে পারেন। উদাহরণস্বরূপ, আপনি একটি বিদ্যমান লেবেল বৈশিষ্ট্য (লেবেলের বিবরণ) আপডেট করতে পারেন অথবা আপনি লেবেলে একটি নতুন Field যোগ করতে পারেন।

লেবেল আপডেট একটি ব্যাচ আপডেট হিসেবে কাজ করে কারণ পদ্ধতিটি আপডেট Request অবজেক্টের একটি তালিকা নেয়। এটি ব্যাচ রিকোয়েস্টে উল্লেখিত একই ক্রম অনুসারে আপডেট করে। ব্যাচ আপডেটের আপডেটগুলি পরমাণুভাবে প্রয়োগ করা হয়। অর্থাৎ, যদি ব্যাচের কোনও অনুরোধ ব্যর্থ হয়, তাহলে সম্পূর্ণ আপডেটটি ব্যর্থ হয় এবং (সম্ভাব্যভাবে নির্ভরশীল) কোনও পরিবর্তন প্রয়োগ করা হয় না। লেবেলটি অপরিবর্তিত থাকে।

যদি আপডেটটি সফল হয়, তাহলে যেকোনো ড্রাইভ আইটেমের সাথে পরিবর্তনগুলি ব্যবহার করার আগে ফলস্বরূপ খসড়া সংশোধন প্রকাশ করতে হবে।

লেবেল অবজেক্ট আপডেট করুন

একটি লেবেলে আরও অনেক ধরণের অবজেক্ট থাকে যা আপডেট করা যায়, যেমন:

• লেবেল বৈশিষ্ট্য
• ক্ষেত্র এবং ক্ষেত্রের ধরণ
• নির্বাচন পছন্দ এবং নির্বাচন পছন্দ বৈশিষ্ট্য

এগুলি এমন অনেক বস্তুর মধ্যে কয়েকটি যা একটি লেবেলের চেহারা এবং কার্যকারিতা নিয়ন্ত্রণ করে।

কার্যক্রমের বিভাগ

labels.delta পদ্ধতি দ্বারা সমর্থিত নিম্নলিখিত ক্রিয়াকলাপগুলিকে নিম্নলিখিত বিস্তৃত বিভাগে ভাগ করা যেতে পারে:

নির্দিষ্ট ক্রিয়াকলাপের আচরণ বর্ণনা করার জন্য পরবর্তী বিভাগে এই বিভাগগুলি ব্যবহার করা হয়েছে।

আপডেটের অনুরোধ

labels.delta পদ্ধতিটি এক বা একাধিক Request অবজেক্ট গ্রহণ করে কাজ করে, প্রতিটি অবজেক্ট এক ধরণের অনুরোধ সম্পাদনের জন্য নির্দিষ্ট করে। অনেক ধরণের অনুরোধ রয়েছে। এখানে বিভিন্ন ধরণের অনুরোধের একটি তালিকা দেওয়া হল, যা বিভিন্ন বিভাগে ভাগ করা হয়েছে।

মাঠের মুখোশ

"আপডেট" এবং "ডিসএবল" ধরণের অনেক অনুরোধের জন্য একটি FieldMask প্রয়োজন। এটি এমন একটি কমা-বিভাজিত তালিকা যা আপনি আপডেট করতে চান এবং অন্যান্য ক্ষেত্রগুলি অপরিবর্তিত রাখেন। আপনি যে ক্ষেত্রগুলি সম্পাদনা করতে চান সেগুলি আপডেট করা হয়েছে তা নিশ্চিত করার জন্য মাস্কটি প্রয়োজন। আপনাকে কমপক্ষে একটি ক্ষেত্র নির্দিষ্ট করতে হবে।

উদাহরণ

একটি লেবেল আপডেট করতে, labels সংগ্রহে delta পদ্ধতি ব্যবহার করুন।

আপনাকে অবশ্যই উল্লেখ করতে হবে:

• ব্যবহারকারীর অ্যাডমিনিস্ট্রেটর শংসাপত্র ব্যবহার করার জন্য useAdminAccess true । অ্যাক্সেস দেওয়ার আগে সার্ভার যাচাই করে যে ব্যবহারকারী লেবেলের একজন অ্যাডমিন।

• একটি Request যা লেবেলের প্রযোজ্য আপডেটগুলি নির্দিষ্ট করে।

• property পদ্ধতির মাধ্যমে একটি লেবেল title ।

• এক বা একাধিক Field ।

• একটি লেবেল রিসোর্স যা প্রতিটি লেবেলের প্রতিনিধিত্ব করে। এতে একটি রিসোর্স Name এবং ID থাকে, যা লেবেলের জন্য একটি বিশ্বব্যাপী অনন্য শনাক্তকারী।

• লেবেল প্রতিক্রিয়াগুলিতে প্রয়োগ করা রিসোর্স ভিউ সেট করার জন্য LabelView হল LABEL_VIEW_FULL । LABEL_VIEW_FULL সমস্ত সম্ভাব্য ক্ষেত্র ফেরত দেয়।

এই উদাহরণে সঠিক লেবেল আপডেট করার জন্য ID ব্যবহার করা হয়েছে।

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()

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 of PUBLISHED লেখা থাকে hasUnpublishedChanges=true অর্থাৎ খসড়া পরিবর্তন আছে, কিন্তু ব্যবহারকারীদের কাছে সেগুলি উপলব্ধ নয়। ব্যবহারকারীদের কাছে পরিবর্তনগুলি দৃশ্যমান হওয়ার আগে আপডেট করা লেবেলটি অবশ্যই PUBLISHED করতে হবে। আরও তথ্যের জন্য, Label lifecycle দেখুন।