مدیریت ویرایش های فایل

این راهنما نحوه استفاده از منبع revisions را برای مدیریت بازبینی‌های فایل، مانند دریافت بازبینی فایل و انتشار بازبینی Google Workspace، توضیح می‌دهد. API گوگل درایو همچنین به شما امکان دانلود بازبینی‌ها را می‌دهد. برای جزئیات بیشتر در مورد اصطلاحات بازبینی، به نمای کلی تغییرات و بازبینی‌ها مراجعه کنید.

برای دسترسی به تاریخچه‌ی ویرایش‌ها، یک کاربر باید role owner ، organizer ، fileOrganizer یا writer را داشته باشد.

برای مشخص کردن فیلدهایی که باید در پاسخ برگردانده شوند، می‌توانید پارامتر سیستمی fields با هر متدی از منبع revisions تنظیم کنید. اگر پارامتر را حذف کنید، سرور مجموعه‌ای پیش‌فرض از فیلدها را برمی‌گرداند. برای مثال، متد revisions.list فقط فیلدهای id ، mimeType ، kind و modifiedTime را برمی‌گرداند. برای برگرداندن فیلدهای مختلف، به بخش Return specific fields مراجعه کنید.

مشخص کردن ویرایش‌هایی که باید از حذف خودکار ذخیره شوند

گوگل درایو به‌طور خودکار نسخه‌های قدیمی‌تر را که دیگر مورد توجه کاربر نیستند، حذف می‌کند.

می‌توان یک نسخه از فایل blob را روی «Keep Forever» تنظیم کرد، به این معنی که این نسخه نمی‌تواند به طور خودکار پاک شود. تا ۲۰۰ نسخه را می‌توان روی «Keep Forever» تنظیم کرد و آنها جزو محدودیت فضای ذخیره‌سازی شما محسوب می‌شوند. نسخه اصلی هرگز به طور خودکار پاک نمی‌شود.

هر ویرایش فایل blob، به غیر از ویرایش head، که به عنوان "Keep Forever" تعیین نشده باشد، قابل پاکسازی است. ویرایش‌های قابل پاکسازی معمولاً به مدت 30 روز نگهداری می‌شوند، اما اگر فایلی 100 ویرایش داشته باشد که به عنوان "Keep Forever" تعیین نشده باشند و یک ویرایش جدید آپلود شود، می‌توان آنها را زودتر پاکسازی کرد.

شما می‌توانید فیلد بولی keepForever از منبع revisions را روی true تنظیم کنید تا ویرایش‌هایی را که نمی‌خواهید Drive پاک کند، علامت‌گذاری کنید. وقتی ویرایش یک فایل blob روی "Keep Forever" تنظیم شود، فقط می‌توان آن را دانلود یا حذف کرد. برای اطلاعات بیشتر، به Download a revision یا Delete a revision مراجعه کنید.

اگر از Drive API نسخه ۲ قدیمی‌تر استفاده می‌کنید، به جای keepForever از فیلد pinned منبع revisions استفاده کنید.

دریافت نسخه اصلاح‌شده فایل

برای دریافت فراداده یا محتوای یک نسخه از فایل، از متد get روی منبع revisions به همراه پارامترهای مسیر fileId و revisionId استفاده کنید. اگر شناسه نسخه را نمی‌دانید، می‌توانید با استفاده از متد list تمام نسخه‌های یک فایل را فهرست کنید .

این متد، متادیتای مربوط به نسخه را به عنوان نمونه‌ای از منبع revisions برمی‌گرداند.

برای تأیید خطر دانلود بدافزارهای شناخته‌شده یا سایر فایل‌های مخرب ، پارامتر پرس‌وجوی acknowledgeAbuse را روی true تنظیم کنید. این فیلد فقط زمانی قابل اجرا است که پارامتر alt=media تنظیم شده باشد و کاربر یا مالک فایل باشد یا یکی از سازمان‌دهندگان درایو مشترکی که فایل در آن قرار دارد.

فهرست کردن ویرایش‌های یک فایل

برای فهرست کردن ویرایش‌های یک فایل، از متد list روی منبع revisions به همراه پارامتر مسیر fileId استفاده کنید. این متد لیستی از ویرایش‌های فایل را برمی‌گرداند.

مهم: فهرست ویرایش‌های برگردانده شده توسط این روش ممکن است برای فایل‌هایی با سابقه ویرایش طولانی، از جمله Google Docs، Sheets و Slides که مرتباً ویرایش می‌شوند، ناقص باشد. ویرایش‌های قدیمی‌تر ممکن است از پاسخ حذف شوند، به این معنی که اولین ویرایش برگردانده شده ممکن است قدیمی‌ترین ویرایش موجود نباشد. تاریخچه ویرایش قابل مشاهده در رابط کاربری Google Drive ممکن است کامل‌تر از فهرست برگردانده شده توسط API باشد.

پارامترهای پرس و جوی زیر را برای سفارشی‌سازی صفحه‌بندی یا فیلتر کردن ویرایش‌ها ارسال کنید:

• pageSize : حداکثر تعداد ویرایش‌هایی که باید در هر صفحه برگردانده شود.

• pageToken : یک توکن صفحه که از فراخوانی لیست قبلی دریافت شده است. این توکن را برای بازیابی صفحه بعدی ارائه دهید.

به‌روزرسانی یک نسخه از فایل

برای به‌روزرسانی یک نسخه روی یک فایل، از متد update روی منبع revisions با پارامترهای مسیر fileId و revisionId استفاده کنید.

این متد نمونه‌ای از یک منبع revisions را برمی‌گرداند.

دانلود نسخه اصلاح‌شده

شما فقط می‌توانید نسخه‌های محتوای فایل blob را که با عنوان "Keep Forever" مشخص شده‌اند، دانلود کنید. اگر می‌خواهید یک نسخه را دانلود کنید، ابتدا مطمئن شوید که آن را روی "Keep Forever" تنظیم کرده‌اید. برای اطلاعات بیشتر، به بخش "مشخص کردن نسخه‌ها برای ذخیره از حذف خودکار " مراجعه کنید.

برای دانلود نسخه محتوای فایل blob یا صادر کردن نسخه محتوای سند Google Workspace، به «دانلود و صادر کردن فایل‌ها» مراجعه کنید.

حذف یک نسخه از فایل

برای حذف دائمی یک نسخه از فایل، از متد delete روی منبع revisions با پارامترهای مسیر fileId و revisionId استفاده کنید.

شما فقط می‌توانید نسخه‌های مربوط به فایل‌های blob با محتوای دودویی در Drive، مانند تصاویر، ویدیوها و PDFها را حذف کنید. می‌توانید نسخه یک فایل blob را زمانی که با عنوان "Keep Forever" علامت‌گذاری شده است، حذف کنید. نسخه‌های سایر فایل‌ها، مانند Google Docs یا Sheets، و آخرین نسخه باقی‌مانده از فایل دودویی، قابل حذف نیستند.

انتشار یک نسخهٔ اصلاح‌شده

برای انتشار یک نسخه از فایل‌های Google Docs، Google Sheets و Google Slides، ویژگی published برای آن فایل در منبع revisions تنظیم کنید. این ویژگی را نمی‌توان برای نسخه‌های Google Sites با استفاده از Drive API تنظیم کرد.

نسخه‌های منتشر شده، تغییرات ایجاد شده در یک فایل را منعکس نمی‌کنند، مگر اینکه ویژگی publishAuto تنظیم شده باشد. اگر این ویژگی روی true تنظیم شده باشد، نسخه‌های جدیدتر یک فایل به طور خودکار منتشر می‌شوند و نسخه‌های قبلی را بازنویسی می‌کنند. اسلایدها و ترسیم‌ها فقط از انتشار مجدد خودکار پشتیبانی می‌کنند و نیاز دارند که ویژگی publishAuto روی true تنظیم شود. برای فایل‌های Sites، publishAuto همیشه false است.

اگر فایل در یک دامنه Google Workspace ایجاد شده باشد، ویژگی publishedOutsideDomain نشان می‌دهد که آیا این نسخه توسط هر کسی قابل دسترسی است یا اینکه محدود به کاربران دامنه است. برای فایل‌های Sites، این ویژگی نشان می‌دهد که آیا مجوز type=anyone وجود دارد یا خیر. برای اطلاعات بیشتر، به فیلد type در منبع permissions مراجعه کنید.

انتشار خودکار همچنین توسط کادر انتخاب «انتشار مجدد خودکار هنگام ایجاد تغییرات» در رابط کاربری Docs و Sheets کنترل می‌شود. برای اطلاعات بیشتر، به بخش «عمومی کردن اسناد، برگه‌ها، اسلایدها و فرم‌های Google » مراجعه کنید.

مباحث مرتبط

• دانلود و خروجی گرفتن از فایل‌ها
• نقش‌ها و مجوزها