ফাইল তৈরি করুন এবং পরিচালনা করুন

এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে Google Drive API ব্যবহার করে Google Drive-এ ফাইল তৈরি এবং পরিচালনা করতে হয়।

ফাইল তৈরি করুন

ড্রাইভে এমন একটি ফাইল তৈরি করতে যাতে কোনও মেটাডেটা বা কন্টেন্ট নেই, কোনও প্যারামিটার ছাড়াই files রিসোর্সে create পদ্ধতি ব্যবহার করুন।

যখন আপনি ফাইল তৈরি করেন, তখন পদ্ধতিটি একটি files রিসোর্স প্রদান করে। ফাইলটিকে এক kind drive.file , একটি id , "Untitled" name এবং application/octet-stream এর একটি mimeType দেওয়া হয়। uploadType টি প্রয়োজনীয় হিসাবে চিহ্নিত করা হয় কিন্তু ডিফল্টভাবে media তে থাকে, তাই আপনাকে আসলে এটি সরবরাহ করতে হবে না।

ড্রাইভ ফাইল সীমা সম্পর্কে আরও তথ্যের জন্য, ফাইল এবং ফোল্ডার সীমা দেখুন।

দ্রষ্টব্য: যখন একজন ড্রাইভ ব্যবহারকারী একটি ফাইল ডাউনলোড করতে চান, অথবা যখন ফাইলটি সিঙ্ক ক্লায়েন্টের মাধ্যমে ডাউনলোড করা হয়, তখন ড্রাইভ নামের উপর ভিত্তি করে একটি সম্পূর্ণ ফাইলের নাম (এক্সটেনশন সহ) তৈরি করে। যেসব ক্ষেত্রে এক্সটেনশনটি অনুপস্থিত থাকে, সেখানে ড্রাইভ ফাইলের MIME প্রকারের উপর ভিত্তি করে এক্সটেনশন নির্ধারণ করার চেষ্টা করে।

ক্ষেত্র প্যারামিটার ব্যবহার করুন

যদি আপনি প্রতিক্রিয়ায় ফেরত দেওয়ার জন্য ক্ষেত্রগুলি নির্দিষ্ট করতে চান, তাহলে আপনি files রিসোর্সের যেকোনো পদ্ধতির সাথে fields সিস্টেম প্যারামিটার সেট করতে পারেন। যদি আপনি fields প্যারামিটারটি বাদ দেন, তাহলে সার্ভার পদ্ধতির জন্য নির্দিষ্ট ক্ষেত্রগুলির একটি ডিফল্ট সেট ফেরত পাঠাবে। উদাহরণস্বরূপ, list পদ্ধতি প্রতিটি ফাইলের জন্য শুধুমাত্র kind , id , name , mimeType এবং resourceKey ক্ষেত্রগুলি ফেরত পাঠায়। বিভিন্ন ক্ষেত্র ফেরত দিতে, নির্দিষ্ট ক্ষেত্রগুলি ফেরত দিন দেখুন।

ফাইলের মালিকানা

যখন ড্রাইভ এপিআই ব্যবহার করে একটি ফাইল তৈরি করা হয়, তখন মালিকানা নিম্নলিখিত উপায়ে অ্যাপ দ্বারা ব্যবহৃত প্রমাণীকরণ শংসাপত্রের উপর নির্ভর করে:

• ব্যবহারকারীর অ্যাকাউন্ট (OAuth 2.0) : যদি অ্যাপ্লিকেশনটি কোনও ব্যবহারকারীর পক্ষে প্রমাণীকরণ করে, তাহলে সেই ব্যবহারকারী ফাইলের মালিক হয়ে যায়। ফাইলটি তখন তাদের মাই ড্রাইভ ফোল্ডারে অথবা একটি নির্দিষ্ট ফোল্ডারে থাকে। এটি তাদের স্টোরেজ কোটা ব্যবহার করে।

• পরিষেবা অ্যাকাউন্ট : যদি অ্যাপ্লিকেশনটি কোনও পরিষেবা অ্যাকাউন্ট ব্যবহার করে প্রমাণীকরণ করে, তবে পরিষেবা অ্যাকাউন্টটি ফাইলের মালিক হবে। ফাইলটি তখন পরিষেবা অ্যাকাউন্টের ডেডিকেটেড ড্রাইভ স্টোরেজে থাকে। স্পষ্টভাবে শেয়ার না করা পর্যন্ত ফাইলগুলি অন্যান্য ড্রাইভ স্টোরেজ অ্যাকাউন্টের মধ্যে প্রদর্শিত হয় না। যদি পরিষেবা অ্যাকাউন্টটি মুছে ফেলা হয়, তবে এর মালিকানাধীন সমস্ত ফাইল অবিলম্বে মুছে ফেলা হবে।

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

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

আপনার ফাইলগুলির সাথে ব্যবহার করার জন্য আইডি তৈরি করুন

files রিসোর্সে generateIds পদ্ধতি আপনাকে অনন্য ফাইল আইডিগুলি আগে থেকে তৈরি করতে দেয় যা ড্রাইভে ফাইল এবং ফোল্ডার তৈরি বা অনুলিপি করার সময় ব্যবহার করা যেতে পারে। ড্রাইভকে স্বয়ংক্রিয়ভাবে সেগুলি বরাদ্দ করার পরিবর্তে, আপনার অ্যাপ থেকে ফাইল আইডিগুলি নিয়ন্ত্রণ করার প্রয়োজন হলে এটি কার্যকর হতে পারে।

আপনি count query প্যারামিটার ব্যবহার করে তৈরি হওয়া ID-এর সংখ্যা সেট করতে পারেন। যদি count সেট না করা থাকে, তাহলে ডিফল্টরূপে 10টি ফেরত পাঠানো হবে। আপনি সর্বাধিক 1,000টি ID-এর জন্য অনুরোধ করতে পারবেন।

আপনি কোন space আইডি ব্যবহার করা যাবে এবং কোন type আইটেমের জন্য আইডি ব্যবহার করা যাবে তাও নির্দিষ্ট করতে পারেন।

একবার একটি আইডি তৈরি হয়ে গেলে, এটি id ক্ষেত্রের মাধ্যমে create বা copy পদ্ধতিতে প্রেরণ করা যেতে পারে। এটি নিশ্চিত করে যে তৈরি বা অনুলিপি করা ফাইলটি পূর্বনির্ধারিত আইডি ব্যবহার করে।

যদি ফাইলটি সফলভাবে তৈরি বা অনুলিপি করা হয়, তাহলে পরবর্তী পুনঃপ্রচেষ্টাগুলি 409 Conflict HTTP স্ট্যাটাস কোড প্রতিক্রিয়া প্রদান করে এবং ডুপ্লিকেট ফাইল তৈরি হয় না।

মনে রাখবেন যে application/vnd.google-apps.drive-sdk এবং application/vnd.google-apps.folder MIME প্রকার ছাড়া Google Workspace ফাইল তৈরির জন্য আগে থেকে তৈরি আইডি সমর্থিত নয়। একইভাবে, Google Workspace ফাইল ফর্ম্যাটে রূপান্তর উল্লেখ করে আপলোডগুলি সমর্থিত নয়।

শুধুমাত্র মেটাডেটা ফাইল তৈরি করুন

মেটাডেটা-শুধুমাত্র ফাইলগুলিতে কোনও কন্টেন্ট থাকে না। মেটাডেটা হল ডেটা (যেমন name , mimeType এবং createdTime ) যা ফাইলটিকে বর্ণনা করে। name মতো ক্ষেত্রগুলি ব্যবহারকারী-অজ্ঞেয়বাদী এবং প্রতিটি ব্যবহারকারীর জন্য একই রকম প্রদর্শিত হয়, যেখানে viewedByMeTime এর মতো ক্ষেত্রগুলিতে ব্যবহারকারী-নির্দিষ্ট মান থাকে।

মেটাডেটা-শুধুমাত্র ফাইলের একটি উদাহরণ হল MIME টাইপ application/vnd.google-apps.folder সহ একটি ফোল্ডার। আরও তথ্যের জন্য, ফোল্ডার তৈরি করুন এবং পূরণ করুন দেখুন। আরেকটি উদাহরণ হল একটি শর্টকাট যা MIME টাইপ application/vnd.google-apps.shortcut সহ ড্রাইভের অন্য ফাইলের দিকে নির্দেশ করে। আরও তথ্যের জন্য, একটি ড্রাইভ ফাইলের শর্টকাট তৈরি করুন দেখুন।

থাম্বনেইল ছবি পরিচালনা করুন

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

একটি বিদ্যমান ফাইল কপি করুন

একটি ফাইল কপি করতে এবং যেকোনো অনুরোধকৃত আপডেট প্রয়োগ করতে, files রিসোর্সে copy পদ্ধতি ব্যবহার করুন। কপি করার জন্য fileId খুঁজে পেতে, list পদ্ধতি ব্যবহার করুন।

আপনি প্যাচ সেমান্টিক্সের মাধ্যমে আপডেট প্রয়োগ করতে পারেন, অর্থাৎ আপনি কোনও রিসোর্সে আংশিক পরিবর্তন করতে পারেন। আপনার অনুরোধে আপনি যে ক্ষেত্রগুলি পরিবর্তন করতে চান তা স্পষ্টভাবে সেট করতে হবে। অনুরোধে অন্তর্ভুক্ত না থাকা যেকোনো ক্ষেত্র তাদের বিদ্যমান মান ধরে রাখবে। আরও তথ্যের জন্য, আংশিক রিসোর্স নিয়ে কাজ করা দেখুন।

আপনি generateIds পদ্ধতি ব্যবহার করে কপি করা ফাইলের ফাইল আইডি আগে থেকে সেট করতে পারেন। আরও তথ্যের জন্য, আপনার ফাইলগুলির সাথে ব্যবহার করার জন্য জেনারেট আইডি দেখুন।

মনে রাখবেন যে কলটি অনুমোদন করার জন্য আপনাকে একটি উপযুক্ত ড্রাইভ API স্কোপ ব্যবহার করতে হবে। ড্রাইভ স্কোপ সম্পর্কে আরও তথ্যের জন্য, Google ড্রাইভ API স্কোপ নির্বাচন করুন দেখুন।

সীমাবদ্ধতা এবং বিবেচনা

ফাইল কপি করার প্রস্তুতি নেওয়ার সময়, এই সীমা এবং বিবেচনাগুলি মনে রাখবেন:

• অনুমতি :

  • files রিসোর্সের DownloadRestrictionsMetadata অবজেক্ট নির্ধারণ করে যে কে ফাইলটি অনুলিপি করতে পারবে। আরও তথ্যের জন্য, ব্যবহারকারীদের আপনার ফাইল ডাউনলোড, মুদ্রণ বা অনুলিপি করা থেকে বিরত রাখুন দেখুন।
  • capabilities.canCopy ফিল্ড রিসোর্স নির্ধারণ করে যে ব্যবহারকারী কোনও ফাইল অনুলিপি করতে পারবেন কিনা। আরও তথ্যের জন্য, ফাইলের ক্ষমতাগুলি বুঝতে দেখুন।
  • যে ব্যবহারকারী কপিটি তৈরি করেছেন তিনি কপি করা ফাইলটির মালিক। উৎস ফাইল থেকে অন্য কোনও শেয়ারিং সেটিংস প্রতিলিপি করা হয় না। যদি কপিটি একটি শেয়ার্ড ফোল্ডারে তৈরি করা হয়, তাহলে এটি সেই ফোল্ডারের অনুমতি উত্তরাধিকারসূত্রে পায়।
  • একটি কপি করা ফাইলের মালিকানা পরিবর্তিত হতে পারে এবং কপিটি মূল ফাইলের শেয়ারিং সেটিংস উত্তরাধিকারসূত্রে নাও পেতে পারে। এই সেটিংস রিসেট করার প্রয়োজন হতে পারে।

• ফাইল ব্যবস্থাপনা :

  • কিছু ফাইল, যেমন থার্ড-পার্টি শর্টকাট , কখনই কপি করা যায় না।
  • আপনি শুধুমাত্র একটি প্যারেন্ট ফোল্ডারে একটি ফাইল কপি করতে পারবেন। একাধিক প্যারেন্ট উল্লেখ করা সমর্থিত নয়। যদি parents ফিল্ড নির্দিষ্ট না থাকে, তাহলে ফাইলটি সোর্স ফাইল থেকে যেকোনো আবিষ্কারযোগ্য প্যারেন্ট উত্তরাধিকার সূত্রে পাবে।
  • যদিও একটি ফোল্ডার এক ধরণের ফাইল, আপনি কোনও ফোল্ডার অনুলিপি করতে পারবেন না। পরিবর্তে, একটি গন্তব্য ফোল্ডার তৈরি করুন এবং বিদ্যমান ফাইলগুলির parents ক্ষেত্রটি গন্তব্য ফোল্ডারে সেট করুন। তারপরে আপনি মূল উৎস ফোল্ডারটি মুছে ফেলতে পারেন।
  • নতুন ফাইলের নাম নির্দিষ্ট না করা হলে, copy পদ্ধতিটি মূল ফাইলের মতো একই নামের একটি ফাইল তৈরি করে।
  • copy অত্যধিক ব্যবহার আপনার ড্রাইভ API কোটার সীমা অতিক্রম করতে পারে। আরও তথ্যের জন্য, ব্যবহারের সীমা দেখুন।

সম্পর্কিত বিষয়

এখানে কিছু পরবর্তী পদক্ষেপ দেওয়া হল যা আপনি চেষ্টা করতে পারেন:

• ফাইল তৈরি বা আপডেট করার সময় ফাইল ডেটা আপলোড করতে, ফাইল ডেটা আপলোড দেখুন।

• একটি নির্দিষ্ট ফোল্ডারে একটি ফাইল তৈরি করতে, একটি নির্দিষ্ট ফোল্ডারে একটি ফাইল তৈরি করুন দেখুন।

• ফাইল সরাতে, ফোল্ডারগুলির মধ্যে ফাইল সরান দেখুন।

• ফাইল মেটাডেটা নিয়ে কাজ করতে, ফাইল মেটাডেটা পরিচালনা করুন দেখুন।

• একটি ফাইল মুছে ফেলতে, "ট্র্যাশ করুন অথবা ফাইল এবং ফোল্ডার মুছে ফেলুন" দেখুন।