লেবেল জন্য অনুসন্ধান

আপনার প্রতিষ্ঠানের একাধিক লেবেল থাকতে পারে, এবং প্রতিটি লেবেলে বিভিন্ন ফিল্ড থাকে। গুগল ড্রাইভ লেবেলস এপিআই (Google Drive Labels API) লেবেল পড়ার সুবিধা দেওয়ার জন্য labels রিসোর্সটি সরবরাহ করে।

এই ডকুমেন্টে ড্রাইভ লেবেল এপিআই (Drive Labels API) ব্যবহার করে লেবেল অনুসন্ধান ও পুনরুদ্ধার করার পদ্ধতি বর্ণনা করা হয়েছে।

পদ্ধতি

labels রিসোর্সটি লেবেলের মান পড়ার জন্য নিম্নলিখিত পদ্ধতিগুলো প্রদান করে, যার প্রত্যেকটিরই একটি নির্দিষ্ট কাজ রয়েছে:

পরিসর	পদ্ধতি
রিসোর্সের নাম অনুসারে একক লেবেল	labels.get
সমস্ত লেবেল	labels.list

রিসোর্সের নাম দ্বারা লেবেল পান

রিসোর্স নাম দিয়ে কোনো একটি লেবেল পেতে, labels রিসোর্সের get মেথডটি ব্যবহার করুন।

একটি লেবেল রিসোর্স name আবশ্যক এবং এটি নিম্নরূপে গঠন করা যেতে পারে:

• labels/{id} অথবা labels/{id}@latest : সর্বশেষ লেবেল সংস্করণটি পায়।
• labels/{id}@published : বর্তমান প্রকাশিত লেবেল সংস্করণটি পাওয়া যায়।
• labels/{id}@{revisionId} : নির্দিষ্ট রিভিশন আইডিতে থাকা লেবেলটি পাওয়া যায়।

লেবেল রেসপন্সগুলিতে প্রয়োগ করা হবে এমন একটি রিসোর্স ভিউ সেট করতে, আপনাকে অবশ্যই একটি LabelView অবজেক্টকে LABEL_VIEW_FULL হিসেবে নির্দিষ্ট করতে হবে। LABEL_VIEW_FULL সমস্ত সম্ভাব্য ফিল্ড রিটার্ন করে।

নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে লেবেলের name ব্যবহার করে তার রিসোর্স নাম দ্বারা একটি একক লেবেল পাওয়া যায়:

পাইথন

# Label name, with or without revision:
#
# Revision specified:
# labels/LABEL_ID@published
# labels/LABEL_ID@latest
# labels/LABEL_ID@1
#
# No revision specified, returns latest revision:
# labels/LABEL_ID
name = 'labels/NAME@published'

# Label view controls level of data in response
view = 'LABEL_VIEW_FULL'

label = service.labels().get(
    name=name,
    view=view
).execute()

নোড.জেএস

// Label name, with or without revision:
//
// Revision specified:
// labels/LABEL_ID@published
// labels/LABEL_ID@latest
// labels/LABEL_ID@1
//
// No revision specified, returns latest revision:
// labels/LABEL_ID
const name = 'labels/NAME@published';

// Label view controls level of data in response
const view = 'LABEL_VIEW_FULL';

service.labels.get({
  name: name,
  view: view
}, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  console.log(res);
});

NAME এর জায়গায় লেবেলের নামটি বসান।

সমস্ত লেবেল তালিকাভুক্ত করুন

লেবেলের তালিকা পেতে, labels রিসোর্সের list মেথডটি ব্যবহার করুন।

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

• এই তালিকা অনুরোধের পরিধি নির্ধারণের জন্য একটি customer কোয়েরি প্যারামিটার। যদি customer সেট করা না থাকে, তবে বর্তমান গ্রাহকের অন্তর্ভুক্ত সমস্ত লেবেল ফেরত দেওয়া হয়।

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

নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে customer কোয়েরি প্যারামিটার ব্যবহার করে লেবেলের একটি তালিকা পাওয়া যায়:

পাইথন

response = service.labels().list(
    customer='customers/CUSTOMER',
    view='LABEL_VIEW_FULL'
).execute()

নোড.জেএস

const params = {
  customer: 'customers/CUSTOMER',
  view: 'LABEL_VIEW_FULL'
};

service.labels.list(params, (err, res) => {
  if (err) return console.error('The API returned an error: ' + err);
  const labels = res.data.labels;
  if (labels) {
    labels.forEach((label) => {
      const name = label.name;
      const title = label.properties.title;
      console.log(`${name}\t${title}`);
    });
  } else {
    console.log('No Labels');
  }
});

CUSTOMER জায়গায় গ্রাহকের নাম বসান।

দ্রষ্টব্য: যদি আপনি শুধুমাত্র প্রকাশিত লেবেল রিভিশনগুলো ফেরত পেতে চান, তাহলে আপনি publishedOnly true তে সেট করতে পারেন। ফলাফলে নিষ্ক্রিয় লেবেলগুলোও অন্তর্ভুক্ত থাকে।