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

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

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

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

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

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

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

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

অপারেশন বিভাগ

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

শ্রেণী বর্ণনা
তৈরি করুন বস্তু যোগ করুন।
আপডেট একটি বস্তুর নির্দিষ্ট বৈশিষ্ট্য আপডেট করুন।
সক্ষম করুন বস্তু সক্ষম করুন.
নিষ্ক্রিয় করুন বস্তু অক্ষম করুন।
মুছে দিন বস্তু সরান.

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

আপডেট অনুরোধ

labels.delta পদ্ধতিটি এক বা একাধিক রিকোয়েস্ট অবজেক্ট গ্রহণ করে কাজ করে, প্রত্যেকটি একটি একক ধরনের অনুরোধ সঞ্চালনের জন্য নির্দিষ্ট করে। বিভিন্ন ধরণের অনুরোধ রয়েছে। এখানে অনুরোধের প্রকারের একটি ব্রেকডাউন রয়েছে, বিভিন্ন বিভাগে গোষ্ঠীবদ্ধ।

অনুরোধের ধরন
লেবেল বৈশিষ্ট্য
আপডেট আপডেট লেবেল বৈশিষ্ট্যের অনুরোধ
মাঠ
তৈরি করুন FieldRequest তৈরি করুন
আপডেট আপডেট ফিল্ড প্রোপার্টিজ অনুরোধ
UpdateFieldTypeRequest
সক্ষম করুন ফিল্ড রিকোয়েস্ট সক্ষম করুন
নিষ্ক্রিয় করুন নিষ্ক্রিয়ক্ষেত্র অনুরোধ
মুছে দিন ডিলিট ফিল্ড রিকোয়েস্ট
নির্বাচন পছন্দ
তৈরি করুন সিলেকশান চয়েস রিকোয়েস্ট তৈরি করুন
আপডেট UpdateSelectionChoicePropertiesRequest
সক্ষম করুন নির্বাচন চয়েস অনুরোধ সক্ষম করুন
নিষ্ক্রিয় করুন অক্ষম নির্বাচন চয়ন অনুরোধ
মুছে দিন মুছুন নির্বাচন পছন্দের অনুরোধ

মাঠের মুখোশ

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

উদাহরণ

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

এছাড়াও আপনাকে অবশ্যই উল্লেখ করতে হবে:

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

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

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

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

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

  • LabelView প্রতিক্রিয়া লেবেল ভিউ প্রয়োগ করা রিসোর্স ভিউ সেট করতে LABEL_VIEW_FULLLABEL_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()

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);
});

লেবেল, ক্ষেত্র বা পছন্দ আপডেট করা হয়, লেবেলের রিভিশন আইডি বৃদ্ধি করা হয় এবং লেবেলটি একটি খসড়া লেবেল হিসাবে একটি ডাটাবেসে সংরক্ষণ করা হয়। লেবেলে hasUnpublishedChanges=true এর সাথে PUBLISHED State রয়েছে যার অর্থ খসড়া পরিবর্তন আছে, কিন্তু সেগুলি ব্যবহারকারীদের জন্য উপলব্ধ নয়। পরিবর্তনগুলি ব্যবহারকারীদের কাছে দৃশ্যমান হওয়ার আগে আপডেট করা লেবেলটি অবশ্যই PUBLISHED উচিত৷ আরও তথ্যের জন্য, লেবেল জীবনচক্র দেখুন।