Google Drive API منبع revisions را فراهم می‌کند تا بتوانید نسخه‌های فایل را دانلود و منتشر کنید. برای جزئیات بیشتر درباره اصطلاحات بازبینی، به نمای کلی تغییرات و تجدیدنظرها مراجعه کنید.
این راهنما نحوه مدیریت ویرایش فایل ها با استفاده از Google Drive API را توضیح می دهد.
ویرایش هایی را برای ذخیره از حذف خودکار مشخص کنید
Google Drive به‌طور خودکار نسخه‌های قدیمی‌تری را که دیگر برای کاربر جالب نیستند حذف می‌کند.
یک ویرایش فایل blob را می توان روی "Keep Forever" تنظیم کرد به این معنی که ویرایش را نمی توان به طور خودکار پاک کرد. حداکثر 200 ویرایش را می‌توان روی "برای همیشه نگه دارید" تنظیم کرد و آنها به عنوان محدودیت فضای ذخیره‌سازی شما محاسبه می‌شوند. نسخه اصلی هرگز به صورت خودکار پاک نمی شود.
هر ویرایش فایل blob، به غیر از نسخه اصلی، که به عنوان "برای همیشه نگه دارید" تعیین نشده باشد، قابل پاکسازی است. نسخه‌های قابل پاکسازی معمولاً به مدت 30 روز حفظ می‌شوند، اما اگر فایلی دارای 100 ویرایش باشد که به‌عنوان «برای همیشه نگه دارید» تعیین نشده‌اند و نسخه جدیدی آپلود شود، می‌توان آنها را زودتر پاک کرد.
می‌توانید فیلد boolean keepForever منبع revisions را روی true تنظیم کنید تا نسخه‌هایی را که نمی‌خواهید Drive پاک کند علامت‌گذاری کنید. هنگامی که یک ویرایش فایل blob روی "Keep Forever" تنظیم شود، فقط می توان آن را دانلود یا حذف کرد. برای اطلاعات بیشتر، به دانلود یک نسخه یا حذف یک نسخه مراجعه کنید.
یک نسخه را دانلود کنید
فقط می‌توانید نسخه‌های محتوای فایل blob را با علامت‌گذاری «برای همیشه نگه دارید» دانلود کنید. اگر می‌خواهید نسخه‌ای را دانلود کنید، ابتدا آن را روی «برای همیشه نگه دارید» تنظیم کنید. برای اطلاعات بیشتر، به تعیین بازبینی‌ها برای ذخیره از حذف خودکار مراجعه کنید.
برای دانلود ویرایش محتوای فایل blob یا صادر کردن ویرایش محتوای سند Google Workspace، به دانلود و صادر کردن فایل‌ها مراجعه کنید.
یک ویرایش را حذف کنید
می‌توانید با فراخوانی روش revisions.delete ، ویرایش فایل blob را برای همیشه حذف کنید، حتی زمانی که به‌عنوان «برای همیشه نگه دارید» علامت‌گذاری شده است.
اگر از Drive API نسخه 2 قدیمی‌تر استفاده می‌کنید، به جای آن از قسمت pinned منبع revisions استفاده کنید.
بازبینی را منتشر کنید
برای انتشار نسخه‌های Google Docs، Google Sheets و Google Slides، ویژگی published برای آن فایل را در منبع revisions تنظیم کنید. این ویژگی را نمی‌توان برای ویرایش‌های Google Sites با استفاده از Drive API تنظیم کرد.
Google Slides و Google Drawings از انتشار نسخه‌های خاص پشتیبانی نمی‌کنند. فقط از انتشار مجدد خودکار آخرین ویرایش پشتیبانی می شود. برای انتشار اسلایدها و طرح‌ها، publishAuto نیز روی true تنظیم کنید.
اگر فایل در یک دامنه Google Workspace ایجاد شده باشد، ویژگی publishedOutsideDomain نشان می‌دهد که آیا ویرایش برای هر کسی قابل دسترسی است یا محدود به کاربران دامنه است. برای فایل های Sites، این ویژگی نشان می دهد که آیا مجوز type=anyone وجود دارد یا خیر. برای اطلاعات بیشتر، فیلد type در منبع permissions ببینید.
ویرایش‌های منتشر شده تغییرات ایجاد شده در فایل را منعکس نمی‌کنند مگر اینکه ویژگی publishAuto تنظیم شده باشد. اگر ویژگی روی true تنظیم شود، ویرایش های جدیدتر یک فایل به طور خودکار منتشر می شود و نسخه های قبلی بازنویسی می شود. اسلایدها و نقشه‌ها فقط از انتشار مجدد خودکار پشتیبانی می‌کنند و باید ویژگی publishAuto روی true تنظیم شود. برای فایل‌های Sites، publishAuto همیشه false است.
انتشار خودکار نیز با کادر انتخاب «انتشار مجدد خودکار در صورت ایجاد تغییرات» در رابط کاربری اسناد و کاربرگ‌ها کنترل می‌شود. برای اطلاعات بیشتر، به عمومی کردن Google Docs، Sheets، Slides & Forms مراجعه کنید.