এই ডকুমেন্টে ফাইলের নামকরণ এবং ইনডেক্সেবল টেক্সট এবং থাম্বনেইলের মতো মেটাডেটা নিয়ে কাজ করার জন্য গুরুত্বপূর্ণ বিবেচ্য বিষয়গুলি অন্তর্ভুক্ত করা হয়েছে। ফাইল সন্নিবেশ এবং পুনরুদ্ধার করতে, files রিসোর্স দেখুন।
মেটাডেটা ওভারভিউ
গুগল ড্রাইভ এপিআই-তে, files রিসোর্স মেটাডেটা প্রতিনিধিত্ব করে। যেসব এপিআইতে মেটাডেটা একটি সাব-অবজেক্ট হয়, তার বিপরীতে, ড্রাইভ এপিআই সম্পূর্ণ files রিসোর্সকে মেটাডেটা হিসেবে বিবেচনা করে। আপনি files রিসোর্সে get বা list পদ্ধতির মাধ্যমে সরাসরি মেটাডেটা অ্যাক্সেস করতে পারেন।
ডিফল্টরূপে, get এবং list পদ্ধতিগুলি শুধুমাত্র আংশিক ক্ষেত্রের সেট ফেরত দেয়। নির্দিষ্ট ডেটা পুনরুদ্ধার করতে, আপনাকে আপনার অনুরোধে fields সিস্টেম প্যারামিটারটি সংজ্ঞায়িত করতে হবে। যদি বাদ দেওয়া হয়, তাহলে সার্ভার পদ্ধতির জন্য নির্দিষ্ট ক্ষেত্রের একটি ডিফল্ট উপসেট ফেরত দেয়। উদাহরণস্বরূপ, list পদ্ধতি প্রতিটি ফাইলের জন্য শুধুমাত্র kind , id , name , mimeType এবং resourceKey ক্ষেত্র ফেরত দেয়। বিভিন্ন ক্ষেত্র ফেরত দিতে, নির্দিষ্ট ক্ষেত্র ফেরত দেখুন।
অতিরিক্তভাবে, মেটাডেটা দৃশ্যমানতা ফাইলটিতে ব্যবহারকারীর ভূমিকার উপর নির্ভর করে। permissions সংস্থান কোনও ফাইল বা ফোল্ডারে ব্যবহারকারীর অনুমোদিত ক্রিয়া নির্ধারণ করে না। পরিবর্তে, files সংস্থানটিতে বুলিয়ান capabilities ক্ষেত্রগুলির একটি সংগ্রহ রয়েছে। Google ড্রাইভ API ফাইল বা ফোল্ডারের সাথে সম্পর্কিত permissions সংস্থান থেকে এই capabilities অর্জন করে। আরও তথ্যের জন্য, ফাইল ক্ষমতাগুলি বুঝতে দেখুন।
Drive API দুটি সীমাবদ্ধ মেটাডেটা স্কোপ অফার করে: drive.metadata এবং drive.metadata.readonly । drive.metadata স্কোপ আপনাকে ফাইল মেটাডেটা দেখতে এবং পরিচালনা করতে দেয়, যখন drive.metadata.readonly হল পঠনযোগ্য। উভয়ই ফাইল সামগ্রীতে অ্যাক্সেস কঠোরভাবে নিষিদ্ধ করে। আরও তথ্যের জন্য, Google Drive API স্কোপগুলি নির্বাচন করুন দেখুন।
অবশেষে, অনুমতি এবং স্কোপ সম্পর্কিত আপনার যুক্তি সর্বদা যাচাই করুন। উদাহরণস্বরূপ, একজন ব্যবহারকারীর সম্পূর্ণ অনুমতি সহ একটি ফাইল থাকতে পারে, কিন্তু যদি আপনার অ্যাপে শুধুমাত্র drive.metadata.readonly স্কোপ থাকে তবে Drive API ফাইলটি পরিবর্তন বা ডাউনলোড করার প্রচেষ্টাগুলিকে ব্লক করবে।
ফাইলের নাম এবং এক্সটেনশন উল্লেখ করুন
Google Drive API ব্যবহার করে ফাইল সন্নিবেশ করার সময় অ্যাপগুলিকে name ) প্রপার্টিতে একটি ফাইল এক্সটেনশন নির্দিষ্ট করতে হবে। উদাহরণস্বরূপ, একটি JPEG ফাইল সন্নিবেশ করার জন্য একটি অপারেশনে মেটাডেটাতে "name": "cat.jpg" এর মতো কিছু নির্দিষ্ট করা উচিত।
পরবর্তী GET প্রতিক্রিয়াগুলিতে কেবল পঠনযোগ্য fileExtension বৈশিষ্ট্য অন্তর্ভুক্ত থাকতে পারে যা মূলত name বৈশিষ্ট্যে নির্দিষ্ট এক্সটেনশন দিয়ে পূর্ণ ছিল। যখন কোনও গুগল ড্রাইভ ব্যবহারকারী কোনও ফাইল ডাউনলোড করার অনুরোধ করেন, অথবা যখন সিঙ্ক ক্লায়েন্টের মাধ্যমে ফাইলটি ডাউনলোড করা হয়, তখন ড্রাইভ নামের উপর ভিত্তি করে একটি সম্পূর্ণ ফাইলের নাম (এক্সটেনশন সহ) তৈরি করে। যেখানে এক্সটেনশনটি অনুপস্থিত থাকে, ড্রাইভ ফাইলের MIME ধরণের উপর ভিত্তি করে এক্সটেনশন নির্ধারণ করার চেষ্টা করে।
ইনডেক্সেবল টেক্সট সংরক্ষণ করুন
ড্রাইভ স্বয়ংক্রিয়ভাবে অনুসন্ধানের জন্য ডকুমেন্টগুলিকে সূচীবদ্ধ করে যখন এটি ফাইলের ধরণ সনাক্ত করে, যার মধ্যে রয়েছে টেক্সট ডকুমেন্ট, পিডিএফ, টেক্সট সহ ছবি এবং অন্যান্য সাধারণ প্রকার। যদি আপনার অ্যাপ অন্যান্য ধরণের ফাইল (যেমন অঙ্কন, ভিডিও এবং শর্টকাট) সংরক্ষণ করে, তাহলে আপনি ফাইলের contentHints.indexableText ক্ষেত্রে সূচীযোগ্য পাঠ্য সরবরাহ করে আবিষ্কারযোগ্যতা উন্নত করতে পারেন।
ইনডেক্সেবল টেক্সট HTML হিসেবে ইনডেক্স করা হয়। যদি আপনি ইনডেক্সেবল টেক্সট স্ট্রিং <section attribute="value1">Here's some text</section> সংরক্ষণ করেন, তাহলে "এখানে কিছু টেক্সট আছে" ইনডেক্স করা হয়, কিন্তু "value1" হয় না। এই কারণে, XML কে ইনডেক্সেবল টেক্সট হিসেবে সংরক্ষণ করা HTML সংরক্ষণের মতো কার্যকর নয়।
indexableText নির্দিষ্ট করার সময়, মনে রাখবেন:
-
contentHints.indexableTextএর আকার সীমা ১২৮ KB। - একজন ব্যবহারকারী যে মূল শব্দ এবং ধারণাগুলি অনুসন্ধান করবেন বলে আশা করেন তা ক্যাপচার করুন।
- গুরুত্ব অনুসারে লেখা সাজানোর চেষ্টা করবেন না কারণ ইনডেক্সার আপনার জন্য এটি দক্ষতার সাথে করে।
- আপনার অ্যাপ্লিকেশনটি প্রতিটি সংরক্ষণের সাথে সূচীযোগ্য পাঠ্য আপডেট করবে।
- নিশ্চিত করুন যে লেখাটি ফাইলের বিষয়বস্তু বা মেটাডেটার সাথে সম্পর্কিত।
শেষের এই বিষয়টি স্পষ্ট মনে হতে পারে, কিন্তু এটি গুরুত্বপূর্ণ। সার্চ রেজাল্টে কোনও ফাইল জোর করে দেখানোর জন্য সাধারণত অনুসন্ধান করা শব্দ যোগ করা ভালো ধারণা নয়। এটি ব্যবহারকারীদের হতাশ করতে পারে, এমনকি তাদের ফাইলটি মুছে ফেলতেও উৎসাহিত করতে পারে।
থাম্বনেল আপলোড করুন
ড্রাইভ স্বয়ংক্রিয়ভাবে অনেক সাধারণ ফাইলের ধরণ, যেমন Google ডক্স, শীট এবং স্লাইডের জন্য থাম্বনেইল তৈরি করে। থাম্বনেইল ব্যবহারকারীকে ড্রাইভ ফাইলগুলি আরও ভালভাবে সনাক্ত করতে সহায়তা করে।
যেসব ফাইলের জন্য ড্রাইভ একটি স্ট্যান্ডার্ড থাম্বনেইল তৈরি করতে পারে না, সেগুলির জন্য আপনি আপনার অ্যাপ্লিকেশন দ্বারা তৈরি একটি থাম্বনেইল ছবি প্রদান করতে পারেন। ফাইল তৈরি বা আপডেট করার সময়, files রিসোর্সে contentHints.thumbnail ক্ষেত্রটি সেট করে একটি থাম্বনেইল আপলোড করুন।
বিশেষ করে:
-
contentHints.thumbnail.imageফিল্ডটি URL এবং ফাইলের নাম নিরাপদ base64-এনকোডেড ছবিতে সেট করুন ( RFC 4648 বিভাগ 5 দেখুন)। - থাম্বনেইলের জন্য
contentHints.thumbnail.mimeTypeক্ষেত্রটিকে উপযুক্ত MIME টাইপে সেট করুন।
যদি ড্রাইভ ফাইল থেকে একটি থাম্বনেইল তৈরি করতে পারে, তাহলে এটি স্বয়ংক্রিয়ভাবে তৈরি হওয়া থাম্বনেইল ব্যবহার করে এবং আপনার আপলোড করা থাম্বনেইল উপেক্ষা করে। যদি এটি একটি থাম্বনেইল তৈরি করতে না পারে, তাহলে এটি আপনার দেওয়া থাম্বনেইল ব্যবহার করে।
থাম্বনেইলগুলি এই নিয়মগুলি মেনে চলতে হবে:
- PNG, GIF, অথবা JPG ফর্ম্যাটে আপলোড করা যাবে।
- প্রস্তাবিত প্রস্থ হল ১৬০০ পিক্সেল।
- সর্বনিম্ন প্রস্থ ২২০ পিক্সেল।
- সর্বোচ্চ ফাইলের আকার ২ মেগাবাইট।
- প্রতিটি সেভের সাথে আপনার অ্যাপ্লিকেশন দ্বারা সেগুলি আপডেট করা উচিত।
আরও তথ্যের জন্য, files রিসোর্স দেখুন।
থাম্বনেইলগুলি পুনরুদ্ধার করুন
আপনি ড্রাইভ ফাইলের জন্য থাম্বনেইল সহ মেটাডেটা পুনরুদ্ধার করতে পারেন। থাম্বনেইল তথ্য files রিসোর্সের thumbnailLink ক্ষেত্রে রাখা হয়।
একটি নির্দিষ্ট থাম্বনেইল ফেরত দিন
নিম্নলিখিত কোড নমুনাটি একটি নির্দিষ্ট ফাইলের জন্য thumbnailLink মেটাডেটা ফেরত দেওয়ার জন্য একটি কোয়েরি প্যারামিটার হিসাবে একাধিক ক্ষেত্র সহ একটি get পদ্ধতির অনুরোধ দেখায়। আরও তথ্যের জন্য, একটি ফাইলের জন্য নির্দিষ্ট ক্ষেত্রগুলি ফেরত দিন দেখুন।
GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=id,name,mimeType,thumbnailLink
আপনি যে ফাইলটি খুঁজতে চান তার fileId দিয়ে FILE_ID প্রতিস্থাপন করুন।
যদি উপলব্ধ থাকে, তাহলে অনুরোধটি ফাইলের থাম্বনেইলে একটি স্বল্পস্থায়ী URL ফেরত পাঠায়। সাধারণত, লিঙ্কটি বেশ কয়েক ঘন্টা স্থায়ী হয়। অনুরোধকারী অ্যাপটি ফাইলের বিষয়বস্তু অ্যাক্সেস করতে পারলেই কেবল ক্ষেত্রটি পূরণ করা হয়। যদি ফাইলটি সর্বজনীনভাবে শেয়ার না করা হয়, তাহলে thumbnailLink এ ফেরত পাঠানো URLটি একটি শংসাপত্রযুক্ত অনুরোধ ব্যবহার করে আনতে হবে।
থাম্বনেইলের একটি তালিকা ফেরত দিন
নিম্নলিখিত কোড নমুনাটি ফাইলের তালিকার জন্য thumbnailLink মেটাডেটা ফেরত দেওয়ার জন্য একটি কোয়েরি প্যারামিটার হিসাবে একাধিক ক্ষেত্র সহ একটি list পদ্ধতির অনুরোধ দেখায়। আরও তথ্যের জন্য, ফাইল এবং ফোল্ডারগুলির জন্য অনুসন্ধান দেখুন।
GET https://www.googleapis.com/drive/v3/files/?fields=files(id,name,mimeType,thumbnailLink)
অনুসন্ধানের ফলাফলগুলিকে একটি নির্দিষ্ট ফাইল প্রকারের মধ্যে সীমাবদ্ধ করতে, MIME প্রকার সেট করতে একটি কোয়েরি স্ট্রিং প্রয়োগ করুন। উদাহরণস্বরূপ, নিম্নলিখিত কোড নমুনাটি দেখায় যে কীভাবে তালিকাটি Google Sheets ফাইলগুলিতে সীমাবদ্ধ করতে হয়। 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)