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

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

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

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

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

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

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

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

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

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

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

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

আপডেট অনুরোধ

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

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

মাঠের মুখোশ

অনেক "আপডেট" এবং "অক্ষম" টাইপের অনুরোধের জন্য একটি 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()

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 করা উচিত৷ আরও তথ্যের জন্য, লেবেল জীবনচক্র দেখুন।