ড্রাইভ API v2 এবং v3 তুলনা নির্দেশিকা

সর্বশেষ গুগল ড্রাইভ API সংস্করণ v3. v3 তে পারফরম্যান্স আরও ভাল কারণ অনুসন্ধানগুলি কেবলমাত্র ক্ষেত্রগুলির একটি উপসেট প্রদান করে। আপনার v2 সংগ্রহের প্রয়োজন না হলে বর্তমান সংস্করণ ব্যবহার করুন। আপনি যদি v2 ব্যবহার করেন, তাহলে v3-এ স্থানান্তর করার কথা বিবেচনা করুন। মাইগ্রেট করতে, ড্রাইভ এপিআই v3 এ মাইগ্রেট দেখুন। সংস্করণ পার্থক্যের সম্পূর্ণ তালিকার জন্য, ড্রাইভ API v2 এবং v3 তুলনা রেফারেন্স দেখুন।

আপনি যদি v2 ব্যবহার চালিয়ে যেতে চান, তাহলে v2 বিকাশকারীদের জন্য কীভাবে v3 গাইডের কিছু নির্দেশাবলী সংশোধন করতে হবে তা জানতে ড্রাইভ API v2 সংশোধনীর গাইড দেখুন।

ড্রাইভ API v3 উন্নতি সম্পর্কে আরও জানতে, আপনি Google ইঞ্জিনিয়ারদের নতুন API ডিজাইন নিয়ে আলোচনা করে নিম্নলিখিত ভিডিওটি দেখতে পারেন।

V3 উন্নতি

কর্মক্ষমতা অপ্টিমাইজ করতে এবং API আচরণ জটিলতা কমাতে, v3 পূর্ববর্তী API সংস্করণের তুলনায় এই উন্নতিগুলি প্রদান করে:

• ফাইল এবং শেয়ার্ড ড্রাইভের জন্য অনুসন্ধানগুলি ডিফল্টরূপে সম্পূর্ণ সম্পদ ফেরত দেয় না, শুধুমাত্র সাধারণভাবে ব্যবহৃত ক্ষেত্রগুলির একটি উপসেট ফেরত দেওয়া হয়। fields সম্পর্কে আরো বিস্তারিত জানার জন্য, files.list পদ্ধতি এবং drives.list পদ্ধতি দেখুন।
• প্রায় সমস্ত পদ্ধতি যা একটি প্রতিক্রিয়া প্রদান করে এখন fields পরামিতি প্রয়োজন। fields প্রয়োজনীয় সমস্ত পদ্ধতির একটি তালিকার জন্য, ড্রাইভ API রেফারেন্স দেখুন৷
• সদৃশ ক্ষমতা আছে যে সম্পদ সরানো হয়েছে. কিছু উদাহরণ:
  • files.list পদ্ধতিটি Children এবং Parents সংগ্রহের মতো একই কার্যকারিতা সম্পন্ন করে, তাই সেগুলি v3 থেকে সরানো হয়েছে।
  • Realtime.* পদ্ধতিগুলি সরানো হয়েছে।
• অনুসন্ধানে ডিফল্টরূপে অ্যাপ ডেটা ফেরত দেওয়া হয় না। v2 তে, আপনি drive.appdata স্কোপ সেট করতে পারেন এবং এটি files.list পদ্ধতি এবং changes.list পদ্ধতি থেকে অ্যাপ্লিকেশন ডেটা ফেরত দেয়, তবে এটি কার্যক্ষমতাকে ধীর করে দেয়। v3-এ, আপনি drive.appdata স্কোপ সেট করেন এবং অ্যাপ্লিকেশন ডেটার অনুরোধ করার জন্য কোয়েরি প্যারামিটার spaces=appDataFolder সেট করেন।
• সমস্ত আপডেট অপারেশন PUT এর পরিবর্তে PATCH ব্যবহার করে।
• Google ডকুমেন্ট রপ্তানি করতে, files.export পদ্ধতি ব্যবহার করুন।
• changes.list পদ্ধতির আচরণ ভিন্ন। আইডি পরিবর্তন করার পরিবর্তে, অস্বচ্ছ পৃষ্ঠা টোকেন ব্যবহার করুন। পরিবর্তন সংগ্রহে পোল করতে, প্রাথমিক মানের জন্য প্রথমে changes.getStartPageToken পদ্ধতিতে কল করুন। পরবর্তী প্রশ্নের জন্য, changes.list পদ্ধতি newStartPageToken মান প্রদান করে।
• আপডেট পদ্ধতিগুলি এখন অ-লিখনযোগ্য ক্ষেত্র নির্দিষ্ট করে এমন অনুরোধ প্রত্যাখ্যান করে।
• about রিসোর্সে v2 exportFormats এবং importFormats ক্ষেত্রগুলি হল অনুমোদিত আমদানি বা রপ্তানি বিন্যাসের তালিকা৷ v3 তে, তারা সব সমর্থিত আমদানি বা রপ্তানির সম্ভাব্য লক্ষ্যগুলির MIME ধরনের মানচিত্র।
• v2 appdata এবং appfolder উপনামগুলি এখন v3-এ appDataFolder ।
• properties সম্পদ v3 থেকে সরানো হয়. files রিসোর্সের properties ক্ষেত্র রয়েছে যাতে সত্য কী-মান জোড়া রয়েছে। properties ক্ষেত্রের মধ্যে সর্বজনীন বৈশিষ্ট্য রয়েছে এবং appProperties ক্ষেত্রে ব্যক্তিগত বৈশিষ্ট্য রয়েছে, তাই দৃশ্যমানতা ক্ষেত্রটির প্রয়োজন নেই।
• files রিসোর্সে modifiedTime ক্ষেত্রটি শেষবার কেউ ফাইলটি পরিবর্তন করার সময় আপডেট করে। v2-এ, modifiedDate ক্ষেত্রটি শুধুমাত্র আপডেটে পরিবর্তনযোগ্য ছিল যদি আপনি setModifiedDate ক্ষেত্রটি সেট করেন।
• files রিসোর্সে viewedByMeTime ফিল্ড স্বয়ংক্রিয়ভাবে আপডেট হয় না।
• Google ডক্স ফরম্যাট আমদানি করতে, আপনি রিসোর্স বডিতে উপযুক্ত টার্গেট mimeType সেট করুন৷ v2 এ, আপনি সেট করেছেন ?convert=true ।
• বিন্যাস সমর্থিত না হলে আমদানি ক্রিয়াকলাপ 400 ত্রুটি প্রদান করে।
• পাঠক এবং মন্তব্যকারীরা অনুমতি দেখতে পারবেন না।
• অনুমতির জন্য me উপনাম সরানো হয়েছে।
• কিছু কার্যকারিতা অনুরোধ সংস্থানের অংশ হিসাবে উপলব্ধ ছিল কিন্তু পরিবর্তে একটি অনুরোধ পরামিতি হিসাবে উপলব্ধ। উদাহরণ স্বরূপ:
  • v2 তে, আপনি একটি প্যারেন্ট ফোল্ডার থেকে একটি চাইল্ড ফাইল মুছে ফেলার জন্য children.delete ব্যবহার করতে পারেন।
  • v3-এ, আপনি URL-এ ?removeParents=parent_id দিয়ে সন্তানের জন্য files.update ব্যবহার করেন।

অন্যান্য পার্থক্য

ক্ষেত্র এবং প্যারামিটারের নাম v3 তে ভিন্ন। কিছু উদাহরণ অন্তর্ভুক্ত:

• name সম্পত্তি files সম্পদের title প্রতিস্থাপন করে।
• Time হল Date পরিবর্তে সমস্ত তারিখ এবং সময় ক্ষেত্রের জন্য প্রত্যয়।
• তালিকা ক্রিয়াকলাপ ফলাফল সেট ধারণ করতে items ক্ষেত্র ব্যবহার করে না। সম্পদের ধরন ফলাফলের জন্য একটি ক্ষেত্র প্রদান করে (যেমন files বা changes )।