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

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

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

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

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

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

یک ویرایش فایل blob را می توان روی "Keep Forever" تنظیم کرد به این معنی که ویرایش را نمی توان به طور خودکار پاک کرد. حداکثر 200 ویرایش را می‌توان روی "برای همیشه نگه دارید" تنظیم کرد و آنها به عنوان محدودیت فضای ذخیره‌سازی شما محاسبه می‌شوند. نسخه اصلی هرگز به صورت خودکار پاک نمی شود.

هر ویرایش فایل blob، به غیر از نسخه اصلی، که به عنوان "برای همیشه نگه دارید" تعیین نشده باشد، قابل پاکسازی است. نسخه‌های قابل پاکسازی معمولاً به مدت 30 روز حفظ می‌شوند، اما اگر فایلی دارای 100 ویرایش باشد که به‌عنوان «برای همیشه نگه دارید» تعیین نشده‌اند و نسخه جدیدی آپلود شود، می‌توان آنها را زودتر پاک کرد.

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

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

یک ویرایش فایل دریافت کنید

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

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

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

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

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

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

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

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

یک ویرایش فایل را به روز کنید

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

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

یک نسخه را دانلود کنید

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

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

یک ویرایش فایل را حذف کنید

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

فقط می‌توانید ویرایش‌های فایل‌های blob با محتوای باینری را در Drive حذف کنید، مانند تصاویر، ویدیوها و فایل‌های PDF. وقتی یک ویرایش فایل حباب به عنوان "برای همیشه نگه دارید" علامت گذاری شده است، می توانید حذف کنید. ویرایش‌های فایل‌های دیگر، مانند 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 ببینید.

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