আপনি একটি নতুন খসড়া সংশোধনের ফলে আপডেট অনুরোধের একটি সেট প্রয়োগ করে একটি একক লেবেল আপডেট করতে পারেন৷ উদাহরণস্বরূপ, আপনি একটি বিদ্যমান লেবেল বৈশিষ্ট্য (লেবেল বিবরণ) আপডেট করতে পারেন বা আপনি লেবেলে একটি নতুন Field
যোগ করতে পারেন।
লেবেল আপডেট একটি ব্যাচ আপডেট হিসাবে কাজ করে কারণ পদ্ধতিটি আপডেটের Request
অবজেক্টের একটি তালিকা নেয়। এটি ব্যাচ অনুরোধে উল্লিখিত একই ক্রম অনুসারে আপডেট করে। ব্যাচ আপডেটের আপডেটগুলি পারমাণবিকভাবে প্রয়োগ করা হয়। অর্থাৎ, যদি ব্যাচের কোনো অনুরোধ অসফল হয়, তাহলে সম্পূর্ণ আপডেটটি অসফল হয় এবং (সম্ভাব্যভাবে নির্ভরশীল) পরিবর্তনগুলির কোনোটিই প্রয়োগ করা হয় না। লেবেল অপরিবর্তিত রাখা হয়.
আপডেট সফল হলে, পরিবর্তনগুলি যেকোন ড্রাইভ আইটেমের সাথে ব্যবহার করার আগে ফলাফলের খসড়া সংশোধন অবশ্যই প্রকাশ করতে হবে৷
লেবেল অবজেক্ট আপডেট করুন
একটি লেবেলে আরও অনেক অবজেক্টের ধরন রয়েছে যা আপডেট করা যেতে পারে, যেমন:
- লেবেল বৈশিষ্ট্য
- ক্ষেত্র এবং ক্ষেত্রের প্রকার
- নির্বাচন পছন্দ এবং নির্বাচন পছন্দ বৈশিষ্ট্য
এগুলি এমন কিছু বস্তু যা একটি লেবেলের চেহারা এবং ক্রিয়াকলাপ নিয়ন্ত্রণ করে।
অপারেশন বিভাগ
labels.delta
পদ্ধতি দ্বারা সমর্থিত নিম্নলিখিত ক্রিয়াকলাপগুলিকে নিম্নলিখিত বিস্তৃত বিভাগে বিভক্ত করা যেতে পারে:
শ্রেণী | বর্ণনা |
---|---|
তৈরি করুন | বস্তু যোগ করুন। |
আপডেট | একটি বস্তুর নির্দিষ্ট বৈশিষ্ট্য আপডেট করুন। |
সক্ষম করুন | বস্তু সক্ষম করুন. |
নিষ্ক্রিয় করুন | বস্তু অক্ষম করুন। |
মুছে দিন | বস্তু সরান. |
এই বিভাগগুলি নির্দিষ্ট ক্রিয়াকলাপের আচরণ বর্ণনা করতে পরবর্তী বিভাগে ব্যবহার করা হয়েছে।
আপডেট অনুরোধ
labels.delta
পদ্ধতিটি এক বা একাধিক রিকোয়েস্ট অবজেক্ট গ্রহণ করে কাজ করে, প্রত্যেকটি একটি একক ধরনের অনুরোধ সঞ্চালনের জন্য নির্দিষ্ট করে। বিভিন্ন ধরণের অনুরোধ রয়েছে। এখানে অনুরোধের প্রকারের একটি ব্রেকডাউন রয়েছে, বিভিন্ন বিভাগে গোষ্ঠীবদ্ধ।
অনুরোধের ধরন | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
লেবেল বৈশিষ্ট্য |
| ||||||||||
মাঠ |
| ||||||||||
নির্বাচন পছন্দ |
|
মাঠের মুখোশ
অনেক "আপডেট" এবং "অক্ষম" টাইপের অনুরোধের জন্য একটি 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
উচিত৷ আরও তথ্যের জন্য, লেবেল জীবনচক্র দেখুন।