এই নির্দেশিকাটি ফাইল রিভিশন পরিচালনা করার জন্য revisions রিসোর্স কীভাবে ব্যবহার করতে হয় তা ব্যাখ্যা করে, যেমন একটি ফাইল রিভিশন পাওয়া এবং একটি গুগল ওয়ার্কস্পেস রিভিশন প্রকাশ করা। গুগল ড্রাইভ এপিআই আপনাকে রিভিশন ডাউনলোড করার সুযোগও দেয়। রিভিশন পরিভাষা সম্পর্কে আরও বিস্তারিত জানতে, পরিবর্তন এবং রিভিশন ওভারভিউ দেখুন।
রিভিশন হিস্ট্রি অ্যাক্সেস করতে হলে, একজন ব্যবহারকারীকে অবশ্যই owner , organizer , fileOrganizer বা writer role অধিকারী হতে হবে।
রেসপন্সে কোন ফিল্ডগুলো ফেরত আসবে তা নির্দিষ্ট করতে, আপনি revisions রিসোর্সের যেকোনো মেথডের সাথে fields সিস্টেম প্যারামিটারটি সেট করতে পারেন। যদি আপনি প্যারামিটারটি বাদ দেন, তাহলে সার্ভার একটি ডিফল্ট ফিল্ড সেট ফেরত দেবে। উদাহরণস্বরূপ, revisions.list মেথডটি শুধুমাত্র id , mimeType , kind এবং modifiedTime ফিল্ডগুলো ফেরত দেয়। ভিন্ন ফিল্ড ফেরত দিতে, নির্দিষ্ট ফিল্ড ফেরত দিন দেখুন।
স্বয়ংক্রিয়ভাবে মুছে যাওয়া থেকে রক্ষা করার জন্য সংস্করণগুলি নির্দিষ্ট করুন।
গুগল ড্রাইভ স্বয়ংক্রিয়ভাবে পুরোনো সংস্করণগুলো মুছে ফেলে, যেগুলো ব্যবহারকারীর কাছে আর প্রাসঙ্গিক নয়।
একটি ব্লব ফাইলের রিভিশনকে "চিরস্থায়ীভাবে রাখুন" (Keep Forever) হিসেবে সেট করা যেতে পারে, যার অর্থ হলো রিভিশনটি স্বয়ংক্রিয়ভাবে মুছে ফেলা যাবে না। সর্বোচ্চ ২০০টি রিভিশনকে "চিরস্থায়ীভাবে রাখুন" হিসেবে সেট করা যায় এবং এগুলো আপনার স্টোরেজ সীমার মধ্যে গণনা করা হয়। হেড রিভিশনটি কখনোই স্বয়ংক্রিয়ভাবে মুছে ফেলা হয় না।
হেড রিভিশন ছাড়া ব্লব ফাইলের অন্য যেকোনো রিভিশন, যা "চিরকালের জন্য রাখুন" (Keep Forever) হিসেবে চিহ্নিত নয়, তা মুছে ফেলা যায়। মুছে ফেলার যোগ্য রিভিশনগুলো সাধারণত ৩০ দিনের জন্য সংরক্ষিত থাকে, কিন্তু যদি কোনো ফাইলে ১০০টি রিভিশন থাকে যা "চিরকালের জন্য রাখুন" হিসেবে চিহ্নিত নয় এবং একটি নতুন রিভিশন আপলোড করা হয়, তবে ফাইলটি তার আগেও মুছে ফেলা যেতে পারে।
আপনি যে রিভিশনগুলো ড্রাইভ থেকে মুছে ফেলতে চান না, সেগুলোকে চিহ্নিত করতে revisions রিসোর্সের ` keepForever বুলিয়ান ফিল্ডটির মান ` true সেট করতে পারেন। একবার কোনো ব্লব ফাইল রিভিশনকে "Keep Forever" হিসেবে সেট করা হলে, সেটি শুধুমাত্র ডাউনলোড বা ডিলিট করা যাবে। আরও তথ্যের জন্য, “Download a revision” বা “Delete a revision” দেখুন।
আপনি যদি পুরোনো Drive API v2 ব্যবহার করেন, তাহলে keepForever এর পরিবর্তে revisions রিসোর্সের pinned ফিল্ডটি ব্যবহার করুন।
ফাইলের একটি সংস্করণ পান
কোনো ফাইল রিভিশনের মেটাডেটা বা কন্টেন্ট পেতে, fileId এবং revisionId পাথ প্যারামিটারসহ ` revisions রিসোর্সের ` get মেথডটি ব্যবহার করুন। যদি আপনি রিভিশন আইডি না জানেন, তবে ` list মেথড ব্যবহার করে একটি ফাইলের সমস্ত রিভিশনের তালিকা দেখতে পারেন।
এই মেথডটি রিভিশনের মেটাডেটাকে একটি revisions রিসোর্সের ইনস্ট্যান্স হিসেবে রিটার্ন করে।
পরিচিত ম্যালওয়্যার বা অন্যান্য ক্ষতিকর ফাইল ডাউনলোড করার ঝুঁকি স্বীকার করতে, acknowledgeAbuse কোয়েরি প্যারামিটারটি true তে সেট করুন। এই ফিল্ডটি শুধুমাত্র তখনই প্রযোজ্য হবে যখন alt=media প্যারামিটারটি সেট করা থাকবে এবং ব্যবহারকারী ফাইলটির মালিক অথবা ফাইলটি যে শেয়ার্ড ড্রাইভে রয়েছে তার একজন সংগঠক হবেন।
একটি ফাইলের সংস্করণগুলি তালিকাভুক্ত করুন
কোনো ফাইলের রিভিশনগুলো তালিকাভুক্ত করতে, fileId পাথ প্যারামিটারসহ ` revisions রিসোর্সের ` list মেথডটি ব্যবহার করুন। এই মেথডটি ফাইল রিভিশনগুলোর একটি তালিকা রিটার্ন করে।
রিভিশনগুলোর পেজিনেশন কাস্টমাইজ করতে বা ফিল্টার করতে নিম্নলিখিত কোয়েরি প্যারামিটারগুলো পাস করুন:
pageSize: প্রতি পৃষ্ঠায় ফেরত দেওয়া সংশোধনের সর্বোচ্চ সংখ্যা।pageToken: পূর্ববর্তী তালিকা আহ্বান থেকে প্রাপ্ত একটি পৃষ্ঠা টোকেন। পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে এই টোকেনটি প্রদান করুন।
ফাইলের সংস্করণ আপডেট করুন
কোনো ফাইলের রিভিশন আপডেট করতে, fileId এবং revisionId পাথ প্যারামিটারসহ ` revisions রিসোর্সের ` update মেথডটি ব্যবহার করুন।
এই মেথডটি একটি revisions রিসোর্সের ইনস্ট্যান্স রিটার্ন করে।
একটি সংস্করণ ডাউনলোড করুন
আপনি শুধুমাত্র "চিরকালের জন্য রাখুন" হিসেবে চিহ্নিত ব্লব ফাইলের কন্টেন্ট রিভিশনগুলোই ডাউনলোড করতে পারবেন। আপনি যদি কোনো রিভিশন ডাউনলোড করতে চান, তবে প্রথমে সেটিকে "চিরকালের জন্য রাখুন" হিসেবে সেট করে নিন। আরও তথ্যের জন্য, স্বয়ংক্রিয়ভাবে মুছে যাওয়া থেকে বাঁচানোর জন্য রিভিশন নির্দিষ্ট করুন দেখুন।
একটি ব্লব ফাইলের কন্টেন্ট রিভিশন ডাউনলোড করতে বা একটি গুগল ওয়ার্কস্পেস ডকুমেন্টের কন্টেন্ট রিভিশন এক্সপোর্ট করতে, “ফাইল ডাউনলোড এবং এক্সপোর্ট” দেখুন।
একটি ফাইল রিভিশন মুছে ফেলুন
কোনো ফাইল রিভিশন স্থায়ীভাবে মুছে ফেলার জন্য, ` revisions রিসোর্সের ` delete মেথডটি fileId এবং revisionId পাথ প্যারামিটারসহ ব্যবহার করুন।
ড্রাইভে আপনি শুধুমাত্র বাইনারি কন্টেন্টযুক্ত ব্লব ফাইল, যেমন ছবি, ভিডিও এবং পিডিএফ-এর রিভিশনগুলো ডিলিট করতে পারবেন। কোনো ব্লব ফাইলের রিভিশনকে "চিরতরে রাখুন" (Keep Forever) হিসেবে চিহ্নিত করা থাকলে, আপনি সেটি ডিলিট করতে পারবেন। গুগল ডক্স বা শিটস-এর মতো অন্যান্য ফাইলের রিভিশন এবং বাইনারি ফাইলটির সর্বশেষ অবশিষ্ট রিভিশন ডিলিট করা যায় না।
একটি সংশোধিত সংস্করণ প্রকাশ করুন
Google Docs, Google Sheets, এবং Google Slides-এর কোনো রিভিশন প্রকাশ করতে, revisions রিসোর্সে সেই ফাইলের জন্য ' published প্রপার্টিটি সেট করুন। Drive API ব্যবহার করে Google Sites রিভিশনের জন্য এই প্রপার্টিটি সেট করা যায় না।
publishAuto প্রপার্টি সেট করা না থাকলে, প্রকাশিত রিভিশনগুলোতে ফাইলে করা পরিবর্তনগুলো প্রতিফলিত হয় না। যদি প্রপার্টিটি true তে সেট করা থাকে, তাহলে ফাইলের নতুন রিভিশনগুলো স্বয়ংক্রিয়ভাবে প্রকাশিত হয়ে আগেরগুলোকে ওভাররাইট করে দেয়। স্লাইড এবং ড্রয়িং শুধুমাত্র স্বয়ংক্রিয় পুনঃপ্রকাশ সমর্থন করে এবং এর জন্য publishAuto প্রপার্টিটি true তে সেট করা আবশ্যক। সাইট ফাইলের ক্ষেত্রে, publishAuto সর্বদা false থাকে।
যদি ফাইলটি একটি গুগল ওয়ার্কস্পেস ডোমেইনে তৈরি করা হয়, তাহলে publishedOutsideDomain প্রপার্টিটি নির্দেশ করে যে রিভিশনটি যে কেউ অ্যাক্সেস করতে পারবে নাকি এটি শুধুমাত্র ডোমেইনের ব্যবহারকারীদের জন্য সীমাবদ্ধ। সাইটস ফাইলের ক্ষেত্রে, এই প্রপার্টিটি নির্দেশ করে যে type=anyone পারমিশন বিদ্যমান আছে কিনা। আরও তথ্যের জন্য, permissions রিসোর্সের type ফিল্ডটি দেখুন।
ডকস এবং শীটস-এর ইউজার ইন্টারফেসে থাকা 'Automatically republish when changes are made' চেকবক্সের মাধ্যমেও স্বয়ংক্রিয় প্রকাশনা নিয়ন্ত্রণ করা হয়। আরও তথ্যের জন্য, 'Make Google Docs, Sheets, Slides & Forms public ' দেখুন।