তৈরি করুন & একটি লেবেল প্রকাশ করুন

এই পৃষ্ঠায় একটি লেবেল তৈরি এবং প্রকাশ করার পদ্ধতি বর্ণনা করা হয়েছে।

একটি লেবেল তৈরি করুন

একটি লেবেল তৈরি করতে, labels কালেকশনের create মেথডটি ব্যবহার করুন। লেবেলে ঐচ্ছিকভাবে এক বা একাধিক Fields থাকতে পারে।

আপনাকে আরও নির্দিষ্ট করে বলতে হবে:

• একটি LabelType ।

• property মেথডের মাধ্যমে একটি লেবেলের title ।

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

এই উদাহরণটি একটি নির্দিষ্ট শিরোনাম এবং ২টি Choices একটি SelectionOptions Field ব্যবহার করে একটি সাধারণ অ্যাডমিন লেবেল তৈরি করে।

পাইথন

label_body = {
'label_type': 'ADMIN',
'properties': {
    'title': 'TITLE'
},
'fields': [{
    'properties': {
        'display_name': 'DISPLAY_NAME'
    },
    'selection_options': {
        'list_options': {},
        'choices': [{
            'properties': {
                'display_name': 'CHOICE_1'
            }
        }, {
            'properties': {
                'display_name': 'CHOICE_2'
            }
        }]
    }
}]
}
response = service.labels().create(
    body=label_body, useAdminAccess=True).execute()

নোড.জেএস

var label = {
'label_type': 'ADMIN',
'properties': {
    'title': 'TITLE'
},
'fields': [{
    'properties': {
    'display_name': 'DISPLAY_NAME'
    },
    'selection_options': {
    'list_options': {},
    'choices': [{
        'properties': {
        'display_name': 'CHOICE_1'
        }
    }, {
        'properties': {
        'display_name': 'CHOICE_2'
        }
    }]
    }
}]
};

service.labels.create({
  'resource': label,
  'use_admin_access': true
}, (err, res) => {
if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

লেবেলটি UNPUBLISHED_DRAFT State তৈরি করা হয়। ফাইলগুলিতে ব্যবহারের জন্য এবং ব্যবহারকারীদের কাছে দৃশ্যমান হওয়ার জন্য এটিকে অবশ্যই PUBLISHED করতে হবে। আরও তথ্যের জন্য, লেবেল লাইফসাইকেল দেখুন।

লেবেল সীমা

লেবেল তৈরি এবং প্রয়োগ করার ক্ষেত্রে নিম্নলিখিত সীমাবদ্ধতাগুলি প্রযোজ্য:

• স্ট্যান্ডার্ড লেবেল—১৫০
• প্রতি লেবেলে ক্ষেত্র—১০
• প্রতি ফাইলে ব্যবহারকারী-প্রদত্ত লেবেল—৫

লেবেলে ফিল্ড নিয়ে কাজ করা

Field Type	ব্যবহারকারীরা যা করতে পারেন	বিন্যাস সংক্রান্ত বিবেচ্য বিষয় এবং সীমাবদ্ধতা
SelectionOptions	তালিকা থেকে এক বা একাধিক বিকল্প নির্বাচন করুন	সর্বোচ্চ ২০০টি অপশন সমর্থন করা হয়। ListOptions এ কনফিগার করা অনুযায়ী একটি ফাইলের জন্য সর্বোচ্চ ১০টি নির্বাচন করা যাবে।
IntegerOptions	একটি সংখ্যাসূচক মান লিখুন	শুধুমাত্র পূর্ণ সংখ্যা সমর্থিত
DateOptions	একটি ক্যালেন্ডার তারিখ নির্বাচন করুন	(ঐচ্ছিক) Date format “দীর্ঘ: মাস ডিডি, ওয়াইওয়াইওয়াই” অথবা “সংক্ষিপ্ত: এমএম/ডিডি/ওয়াইওয়াই” হিসেবে সেট করা যেতে পারে।
TextOptions	টেক্সট বক্সে টেক্সট লিখুন	সর্বোচ্চ ১০০টি অক্ষর সমর্থন করা হয়।
UserOptions	গুগল ওয়ার্কস্পেস কন্ট্যাক্টস থেকে এক বা একাধিক ব্যবহারকারীকে নির্বাচন করুন।	ListOptions এ কনফিগার করা অনুযায়ী একটি ফাইলের জন্য ব্যবহারকারীর এন্ট্রির সর্বোচ্চ সংখ্যা হল ১০।

একটি লেবেল প্রকাশ করুন

লেবেল এপিআই আপনাকে একটি খসড়া লেবেল সম্পূর্ণ হয়ে গেলে তা প্রকাশ করার সুযোগ দেয়।

একটি লেবেল প্রকাশ করতে, publish পদ্ধতিটি ব্যবহার করুন এবং নির্দিষ্ট করুন:

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

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

এই উদাহরণটি সঠিক লেবেল শনাক্ত ও প্রকাশ করতে ID ব্যবহার করে।

পাইথন

service.labels().publish(
name='labels/ID',
body={
  'use_admin_access': True
}).execute()

নোড.জেএস

service.labels.publish({
  'resource': {
    'use_admin_access': true
},
'name': 'labels/ID'
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

লেবেলটি প্রকাশিত হয়ে গেলে, এটি 'প্রকাশিত' PUBLISHED State চলে যায় এবং এর রিভিশন আইডি এক বৃদ্ধি পায়। এরপর লেবেলটি ব্যবহারকারীদের কাছে দৃশ্যমান হয় এবং ফাইলগুলিতে প্রয়োগ করা যায়। আরও তথ্যের জন্য, লেবেল জীবনচক্র (Label lifecycle ) দেখুন।

লেবেল প্রকাশ করার ক্ষেত্রে সীমাবদ্ধতা

• একবার প্রকাশিত হলে, একটি লেবেল তার মূল খসড়া অবস্থায় ফিরে আসতে পারে না। আরও তথ্যের জন্য, লেবেল জীবনচক্র দেখুন।

• একটি লেবেল প্রকাশ করলে একটি নতুন প্রকাশিত সংস্করণ তৈরি হয়। পূর্ববর্তী সমস্ত খসড়া সংস্করণ মুছে ফেলা হয়। পূর্বে প্রকাশিত সংস্করণগুলি সংরক্ষিত থাকে, তবে প্রয়োজন অনুযায়ী স্বয়ংক্রিয়ভাবে মুছে ফেলা হয়।

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

  • লেবেলটি সরাসরি মুছে ফেলা হয়। (প্রথমে এটিকে নিষ্ক্রিয় করতে হবে, তারপর মুছতে হবে।)
  • Field.FieldType পরিবর্তন করা হয়েছে।
  • ফিল্ড ভ্যালিডেশন অপশনের আপডেটের ফলে পূর্বে গৃহীত কোনো কিছু বাতিল হয়ে যায়।
  • সর্বোচ্চ অংশগ্রহণের সংখ্যা হ্রাস করা হয়েছে।