কাস্টম ফাইল বৈশিষ্ট্য যোগ করুন

কাস্টম ফাইল প্রোপার্টি হলো কী-ভ্যালু পেয়ার, যা একটি গুগল ড্রাইভ ফাইলের জন্য কাস্টম মেটাডেটা (যেমন ট্যাগ), অন্যান্য ডেটা স্টোর থেকে আইডি, ওয়ার্কফ্লো অ্যাপ্লিকেশনগুলোর মধ্যে শেয়ার করা তথ্য ইত্যাদি সংরক্ষণ করতে ব্যবহৃত হয়। উদাহরণস্বরূপ, আপনি প্রথম ত্রৈমাসিকে (Q1) সেলস ডিপার্টমেন্ট দ্বারা তৈরি করা সমস্ত ডকুমেন্টে ফাইল প্রোপার্টি যোগ করতে পারেন।

সকল অ্যাপ্লিকেশনের জন্য দৃশ্যমান প্রোপার্টি যোগ করতে, files রিসোর্সের properties ফিল্ডটি ব্যবহার করুন। আপনার অ্যাপের জন্য সীমাবদ্ধ প্রোপার্টি যোগ করতে, files রিসোর্সের appProperties ফিল্ডটি ব্যবহার করুন।

প্রপার্টিগুলো সার্চ এক্সপ্রেশনেও ব্যবহার করা যেতে পারে।

এটি একটি সাধারণ প্রপার্টির কাঠামো যা কোনো ড্রাইভ ফাইলের ডাটাবেস আইডি সংরক্ষণ করতে ব্যবহৃত হতে পারে।

"appProperties": {
  "additionalID": "ID",
}

{
  'key':        'additionalID',
  'value':      'ID',
  'visibility': 'PRIVATE'
}

কাস্টম ফাইল প্রোপার্টি নিয়ে কাজ করা

এই অংশে ব্যাখ্যা করা হয়েছে কীভাবে কিছু কাস্টম ফাইল প্রপার্টি-সম্পর্কিত কাজ সম্পাদন করতে হয়, যা সমস্ত অ্যাপ্লিকেশনকে প্রভাবিত করে।

কাস্টম ফাইল প্রোপার্টি যোগ বা আপডেট করুন

সকল অ্যাপ্লিকেশনের কাছে দৃশ্যমান প্রোপার্টি যোগ বা আপডেট করতে, files রিসোর্সের properties ফিল্ডটি সেট করার জন্য files.update মেথডটি ব্যবহার করুন।

PATCH https://www.googleapis.com/drive/v3/files/FILE_ID

{
  "properties": {
    "name": "wrench",
    "mass": "1.3kg",
    "count": "3"
  }
}

এছাড়াও আপনি গুগল অ্যাপস স্ক্রিপ্টের অ্যাডভান্সড ড্রাইভ সার্ভিস ব্যবহার করে কোনো ফাইলে কাস্টম প্রপার্টি যোগ করতে পারেন। আরও তথ্যের জন্য, কাস্টম প্রপার্টি যোগ করা দেখুন।

কাস্টম ফাইলের বৈশিষ্ট্যগুলি পান বা তালিকাভুক্ত করুন

সকল অ্যাপ্লিকেশনের জন্য দৃশ্যমান প্রোপার্টিগুলো দেখতে, ফাইলটির কাস্টম প্রোপার্টিগুলো পুনরুদ্ধার করতে files.get মেথডটি ব্যবহার করুন।

GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=properties

রেসপন্সটিতে একটি properties অবজেক্ট থাকে, যার মধ্যে কী-ভ্যালু পেয়ারের একটি কালেকশন থাকে।

{
  "properties": {
    "name": "wrench",
    "mass": "1.3kg",
    "count": "3"
  }
}

কাস্টম ফাইল প্রোপার্টিগুলো মুছে ফেলুন

সকল অ্যাপ্লিকেশনের কাছে দৃশ্যমান প্রপার্টি ভ্যালুগুলো মুছে ফেলতে, files.update মেথড ব্যবহার করে files রিসোর্সের properties ফিল্ডটিকে null-এ সেট করুন।

PATCH https://www.googleapis.com/drive/v3/files/FILE_ID

{
  "name": null
}

পরিবর্তনটি দেখতে, ফাইলটির properties অবজেক্টটি পাওয়ার জন্য files.get মেথডটি কল করুন।

{
  "properties": {
    "mass": "1.3kg",
    "count": "3"
  }
}

কাস্টম ফাইল বৈশিষ্ট্যের সীমাবদ্ধতা

কাস্টম প্রপার্টিগুলোর নিম্নলিখিত সীমাবদ্ধতা রয়েছে:

• প্রতিটি ফাইলে সকল উৎস থেকে সংগৃহীত সর্বোচ্চ ১০০টি কাস্টম প্রপার্টি থাকতে পারবে।
• প্রতিটি ফাইলে সকল উৎস থেকে সংগৃহীত সর্বোচ্চ ৩০টি পাবলিক প্রপার্টি থাকতে পারবে।
• যেকোনো একটি অ্যাপ্লিকেশন থেকে প্রতি ফাইলে সর্বোচ্চ ৩০টি ব্যক্তিগত সম্পত্তি।
• UTF-8 এনকোডিং-এ প্রতিটি প্রপার্টি স্ট্রিং-এর জন্য (কী এবং ভ্যালু উভয় সহ) সর্বোচ্চ ১২৪ বাইট ব্যবহার করা যায়। উদাহরণস্বরূপ, একটি প্রপার্টির কী যদি ১০ অক্ষরের হয়, তবে তার ভ্যালুতে কেবল ১১৪টি অক্ষর থাকতে পারে। একইভাবে, যে প্রপার্টির ভ্যালুর জন্য ১০০টি অক্ষরের প্রয়োজন, তার কী-এর জন্য সর্বোচ্চ ২৪টি অক্ষর ব্যবহার করা যেতে পারে।

আরও তথ্যের জন্য, files রিসোর্সটি দেখুন। ড্রাইভ এপিআই ভি২ (Drive API v2)-এর জন্য, properties রিসোর্সটি দেখুন।

ব্যক্তিগত কাস্টম ফাইলের বৈশিষ্ট্যগুলিতে অ্যাক্সেস করুন

আপনি শুধুমাত্র একটি OAuth 2.0 ক্লায়েন্ট আইডি দিয়ে প্রাপ্ত অ্যাক্সেস টোকেন ব্যবহার করে করা একটি প্রমাণীকৃত অনুরোধের মাধ্যমে appProperties ফিল্ড ব্যবহার করে ব্যক্তিগত প্রোপার্টিগুলো পুনরুদ্ধার করতে পারবেন। আপনি ব্যক্তিগত প্রোপার্টিগুলো পুনরুদ্ধার করতে কোনো এপিআই কী ব্যবহার করতে পারবেন না।