এই নথিতে ফাইলের নামকরণ এবং মেটাডেটা যেমন সূচীযোগ্য পাঠ্য এবং থাম্বনেইলগুলির সাথে কাজ করার জন্য গুরুত্বপূর্ণ বিবেচনাগুলি কভার করে৷ ফাইল সন্নিবেশ এবং পুনরুদ্ধার করতে, files সম্পদ দেখুন.
ফাইলের নাম এবং এক্সটেনশন উল্লেখ করুন
Google ড্রাইভ API-এর সাথে ফাইল ঢোকানোর সময় অ্যাপগুলির শিরোনাম সম্পত্তিতে একটি ফাইল এক্সটেনশন উল্লেখ করা উচিত। উদাহরণস্বরূপ, একটি JPEG ফাইল সন্নিবেশ করার জন্য একটি অপারেশন মেটাডেটাতে "name": "cat.jpg" মত কিছু নির্দিষ্ট করা উচিত।
পরবর্তী GET প্রতিক্রিয়াগুলির মধ্যে শুধুমাত্র-পঠনযোগ্য fileExtension বৈশিষ্ট্য অন্তর্ভুক্ত থাকতে পারে যা মূলত name সম্পত্তিতে নির্দিষ্ট করা এক্সটেনশনের সাথে পপুলেট করা হয়। যখন একজন Google ড্রাইভ ব্যবহারকারী একটি ফাইল ডাউনলোড করার অনুরোধ করে, অথবা যখন ফাইলটি সিঙ্ক ক্লায়েন্টের মাধ্যমে ডাউনলোড করা হয়, তখন ড্রাইভ শিরোনামের উপর ভিত্তি করে একটি সম্পূর্ণ ফাইলের নাম (এক্সটেনশন সহ) তৈরি করে। যে ক্ষেত্রে এক্সটেনশনটি অনুপস্থিত, ড্রাইভ ফাইলের MIME প্রকারের উপর ভিত্তি করে এক্সটেনশন নির্ধারণ করার চেষ্টা করে৷
ইনডেক্সযোগ্য পাঠ্য সংরক্ষণ করুন
ড্রাইভ টেক্সট ডকুমেন্ট, পিডিএফ, টেক্সট সহ ইমেজ এবং অন্যান্য সাধারণ ধরন সহ ফাইলের ধরন শনাক্ত করলে অনুসন্ধানের জন্য ডকুমেন্টগুলিকে স্বয়ংক্রিয়ভাবে সূচী করে। যদি আপনার অ্যাপটি অন্যান্য ধরনের ফাইল (যেমন অঙ্কন, ভিডিও এবং শর্টকাট) সংরক্ষণ করে, তাহলে আপনি ফাইলের contentHints.indexableText ফিল্ডে ইনডেক্সযোগ্য পাঠ্য সরবরাহ করে আবিষ্কারযোগ্যতা উন্নত করতে পারেন।
ইনডেক্সযোগ্য পাঠ্য এইচটিএমএল হিসাবে সূচিত করা হয়। আপনি যদি ইনডেক্সযোগ্য পাঠ্য স্ট্রিং <section attribute="value1">Here's some text</section> সংরক্ষণ করেন, তাহলে "এখানে কিছু পাঠ্য" ইন্ডেক্স করা হয়, কিন্তু "মান 1" হয় না। এই কারণে, সূচীযোগ্য পাঠ্য হিসাবে XML সংরক্ষণ করা HTML সংরক্ষণের মতো কার্যকর নয়।
indexableText উল্লেখ করার সময়, এছাড়াও মনে রাখবেন:
-
contentHints.indexableTextএর আকার সীমা হল 128 KB৷ - মূল শর্তাবলী এবং ধারণাগুলি ক্যাপচার করুন যা আপনি একজন ব্যবহারকারী অনুসন্ধান করতে চান।
- গুরুত্ব অনুসারে পাঠ্য বাছাই করার চেষ্টা করবেন না কারণ সূচকটি আপনার জন্য এটি দক্ষতার সাথে করে।
- আপনার অ্যাপ্লিকেশন প্রতিটি সংরক্ষণের সাথে সূচীযোগ্য পাঠ্য আপডেট করা উচিত।
- নিশ্চিত করুন যে পাঠ্যটি ফাইলের বিষয়বস্তু বা মেটাডেটার সাথে সম্পর্কিত।
এই শেষ বিন্দু সুস্পষ্ট মনে হতে পারে, কিন্তু এটা গুরুত্বপূর্ণ. একটি ফাইলকে সার্চের ফলাফলে প্রদর্শিত হতে বাধ্য করার জন্য সাধারণত অনুসন্ধান করা শব্দগুলি যোগ করা ভাল ধারণা নয়৷ এটি ব্যবহারকারীদের হতাশ করতে পারে, এবং এমনকি ফাইল মুছে ফেলতে তাদের অনুপ্রাণিত করতে পারে।
থাম্বনেইল আপলোড করুন
ড্রাইভ স্বয়ংক্রিয়ভাবে অনেক সাধারণ ফাইলের জন্য থাম্বনেল তৈরি করে, যেমন Google ডক্স, পত্রক এবং স্লাইড। থাম্বনেইলগুলি ব্যবহারকারীকে ড্রাইভ ফাইলগুলি আরও ভালভাবে সনাক্ত করতে সহায়তা করে।
যে ধরনের ফাইলগুলির জন্য ড্রাইভ একটি স্ট্যান্ডার্ড থাম্বনেইল তৈরি করতে পারে না, আপনি আপনার অ্যাপ্লিকেশন দ্বারা তৈরি একটি থাম্বনেইল চিত্র প্রদান করতে পারেন৷ ফাইল তৈরি বা আপডেটের সময়, files রিসোর্সে contentHints.thumbnail ক্ষেত্র সেট করে একটি থাম্বনেইল আপলোড করুন।
বিশেষভাবে:
- URL-এ
contentHints.thumbnail.imageফিল্ড সেট করুন এবং ফাইলের নাম নিরাপদ base64-এনকোডেড ইমেজ (দেখুন RFC 4648 বিভাগ 5 )। - থাম্বনেইলের জন্য উপযুক্ত MIME প্রকারে
contentHints.thumbnail.mimeTypeক্ষেত্রটি সেট করুন।
ড্রাইভ যদি ফাইল থেকে একটি থাম্বনেল তৈরি করতে পারে, তাহলে এটি স্বয়ংক্রিয়ভাবে তৈরি হওয়া একটি ব্যবহার করে এবং আপনার আপলোড করা কোনোটিকে উপেক্ষা করে। এটি একটি থাম্বনেইল তৈরি করতে না পারলে, এটি আপনার দেওয়া একটি ব্যবহার করে।
থাম্বনেইলগুলিকে এই নিয়মগুলি মেনে চলতে হবে:
- PNG, GIF, বা JPG ফর্ম্যাটে আপলোড করা যেতে পারে।
- প্রস্তাবিত প্রস্থ হল 1600 পিক্সেল।
- সর্বনিম্ন প্রস্থ 220 পিক্সেল।
- সর্বাধিক ফাইলের আকার 2 এমবি।
- সেগুলি প্রতিটি সংরক্ষণের সাথে আপনার অ্যাপ্লিকেশন দ্বারা আপডেট করা উচিত।
আরও তথ্যের জন্য, files সংস্থান দেখুন।
থাম্বনেল পুনরুদ্ধার করুন
আপনি ড্রাইভ ফাইলগুলির জন্য থাম্বনেল সহ মেটাডেটা পুনরুদ্ধার করতে পারেন৷ থাম্বনেইল তথ্য files রিসোর্সের thumbnailLink ফিল্ডে রাখা হয়।
একটি নির্দিষ্ট থাম্বনেইল ফেরত দিন
নিম্নলিখিত কোড নমুনা একটি নির্দিষ্ট ফাইলের জন্য thumbnailLink মেটাডেটা ফেরত দেওয়ার জন্য একটি ক্যোয়ারী প্যারামিটার হিসাবে একাধিক ক্ষেত্র সহ একটি files.get পদ্ধতির অনুরোধ দেখায়। আরও তথ্যের জন্য, একটি ফাইলের জন্য নির্দিষ্ট ক্ষেত্র ফেরত দেখুন।
GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=id,name,mimeType,thumbnailLink
আপনি যে ফাইলটি খুঁজতে চান তার fileId দিয়ে FILE_ID প্রতিস্থাপন করুন।
যদি উপলব্ধ হয়, অনুরোধটি ফাইলের থাম্বনেইলে একটি স্বল্পকালীন URL প্রদান করে। সাধারণত, লিঙ্কটি কয়েক ঘন্টা স্থায়ী হয়। ক্ষেত্রটি তখনই পপুলেট করা হয় যখন অনুরোধকারী অ্যাপ ফাইলের বিষয়বস্তু অ্যাক্সেস করতে পারে। যদি ফাইলটি সর্বজনীনভাবে ভাগ করা না হয়, তাহলে thumbnailLink লিঙ্কে ফিরে আসা URL একটি শংসাপত্রযুক্ত অনুরোধ ব্যবহার করে আনতে হবে।
থাম্বনেইলের একটি তালিকা ফেরত দিন
নিম্নলিখিত কোড নমুনা ফাইলগুলির একটি তালিকার জন্য thumbnailLink মেটাডেটা ফেরত দেওয়ার জন্য একটি ক্যোয়ারী প্যারামিটার হিসাবে একাধিক ক্ষেত্র সহ একটি files.list পদ্ধতি অনুরোধ দেখায়। আরও তথ্যের জন্য, ফাইল এবং ফোল্ডারগুলির জন্য অনুসন্ধান দেখুন।
GET https://www.googleapis.com/drive/v3/files/?fields=files(id,name,mimeType,thumbnailLink)
একটি নির্দিষ্ট ফাইল প্রকারে অনুসন্ধান ফলাফল সীমাবদ্ধ করতে, MIME প্রকার সেট করতে একটি ক্যোয়ারী স্ট্রিং প্রয়োগ করুন৷ উদাহরণস্বরূপ, নিম্নলিখিত কোড নমুনাটি Google পত্রক ফাইলগুলিতে তালিকাটিকে কীভাবে সীমাবদ্ধ করতে হয় তা দেখায়৷ MIME প্রকারের বিষয়ে আরও তথ্যের জন্য, Google Workspace এবং Google Drive সমর্থিত MIME প্রকারগুলি দেখুন।
GET https://www.googleapis.com/drive/v3/files/q=mimeType='application/vnd.google-apps.spreadsheet'&fields=files(id,name,mimeType,thumbnailLink)