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

এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে Google ড্রাইভ এপিআই ব্যবহার করে Google ড্রাইভে ফাইল তৈরি ও পরিচালনা করতে হয়।

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

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

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

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

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

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

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

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

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

আপনি আইডিগুলি ব্যবহার করা যেতে পারে এমন 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 কোটা সীমা অতিক্রম করতে পারে। আরও তথ্যের জন্য, ব্যবহারের সীমা দেখুন।

এখানে কয়েকটি পরবর্তী ধাপ রয়েছে যা আপনি চেষ্টা করতে পারেন: