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

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

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

মনে রাখবেন: আপনি Google Drive API (v2)-এর পুরনো ভার্সন ব্যবহার করলে, properties.insert ব্যবহার করে আপনার অ্যাপে প্রপার্টি যোগ করতে properties রিসোর্স ব্যবহার করুন। ভার্সনগুলির মধ্যে পার্থক্যের সম্পূর্ণ তালিকার জন্য, Drive API v2 ও v3-এর তুলনামূলক রেফারেন্স দেখুন।

সার্চ এক্সপ্রেশন-এও প্রপার্টি ব্যবহার করা যেতে পারে।

এটি একটি সাধারণ প্রপার্টির স্ট্রাকচার যা ফাইলে Drive ফাইলের ডেটাবেসের আইডি স্টোর করার জন্য ব্যবহার করা হতে পারে।

Drive API v3

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

Drive API v2

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

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

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

মনে রাখবেন: Google Drive UI-তে কাস্টম প্রপার্টি এডিট করার জন্য কোনও বিল্ট-ইন উপায় নেই।

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

সব অ্যাপ্লিকেশনে দেখা যায় এমন প্রপার্টি যোগ বা আপডেট করতে, files রিসোর্সের properties ফিল্ড সেট করতে files.update পদ্ধতি ব্যবহার করুন।

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

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

এছাড়াও, Google Apps Script-এ উন্নত Drive পরিষেবা ব্যবহার করে আপনি কোনও ফাইলে কাস্টম প্রপার্টি যোগ করতে পারবেন। আরও তথ্যের জন্য, কাস্টম প্রপার্টি যোগ করা দেখুন।

কাস্টম ফাইল প্রপার্টি পান বা তালিকাভুক্ত করুন

সব অ্যাপ্লিকেশনে দেখা যায় এমন প্রপার্টি দেখতে, ফাইলের জন্য কাস্টম ফাইল প্রপার্টি ফিরিয়ে আনতে files.get পদ্ধতি ব্যবহার করুন।

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

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

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

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

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

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 রিসোর্স দেখুন।

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

আপনি শুধুমাত্র appProperties ফিল্ড ব্যবহার করে ব্যক্তিগত প্রপার্টি ফিরিয়ে আনতে পারবেন। এর জন্য আপনাকে একটি যাচাই করা অনুরোধ পাঠাতে হবে, যা OAuth 2.0 ক্লায়েন্ট আইডি থেকে পাওয়া অ্যাক্সেস টোকেন ব্যবহার করে। ব্যক্তিগত প্রপার্টি ফিরিয়ে আনতে আপনি API কী ব্যবহার করতে পারবেন না।