Google Drive API منبع Revisions را فراهم می کند تا بتوانید نسخه های فایل را دانلود و منتشر کنید. برای جزئیات بیشتر درباره اصطلاحات بازبینی، به نمای کلی تغییرات و تجدیدنظرها مراجعه کنید.
ویرایش هایی را برای ذخیره از حذف خودکار مشخص کنید
Google Drive بهطور خودکار نسخههای قدیمیتری را که دیگر برای کاربر جالب نیستند حذف میکند. برای جلوگیری از این اتفاق، میتوانید پرچم بولین keepRevisionForever
روی true
تنظیم کنید تا نسخههایی را که نمیخواهید Drive پاک کند علامتگذاری کنید.
یک نسخه را دانلود کنید
می توانید از مقدار فیلد headRevisionId
از منبع Files برای دانلود آخرین نسخه استفاده کنید. این ویرایشی را واکشی می کند که با فراداده فایلی که قبلاً بازیابی کرده اید مطابقت دارد. برای دانلود دادههای تمام نسخههای قبلی فایل که هنوز در فضای ابری ذخیره میشوند، میتوانید revisions.list
را فراخوانی کنید، که همه revisionIds را دریافت میکند.
برای دانلود محتوای ویرایش، باید متد revisions.get
را با پارامتر alt=media
فراخوانی کنید. ویرایشهای Google Docs، Sheets و Slides را نمیتوان دانلود کرد.
ویرایشهای Google Docs، Google Drawings و Slides اعداد نسخهها را بهطور خودکار افزایش میدهند. با این حال، در صورت حذف ویرایشها، ممکن است یک سری از اعداد دارای شکاف باشند، بنابراین هنگام بازیابی نسخهها نباید به اعداد متوالی تکیه کنید.
بازبینی را منتشر کنید
برای انتشار نسخههای Google Docs، Sheets و Slides، ویژگی published
برای آن فایل را در ویژگی Revisions تنظیم میکنید. این ویژگی را نمیتوان برای ویرایشهای Google Sites از طریق API Drive تنظیم کرد.
اگر فایل در یک دامنه Google Workspace ایجاد شده باشد، ویژگی publishedOutsideDomain
نشان میدهد که آیا ویرایش برای هر کسی قابل دسترسی است یا محدود به کاربران دامنه است. برای فایلهای Google Sites، این ویژگی نشان میدهد که آیا مجوز type=anyone
وجود دارد یا خیر.
ویرایشهای منتشر شده تغییرات ایجاد شده در فایل را منعکس نمیکنند مگر اینکه ویژگی publishAuto
تنظیم شده باشد. اگر آن ویژگی روی true تنظیم شود، ویرایشهای جدیدتر یک فایل بهطور خودکار منتشر میشوند و نسخههای قبلی بازنویسی میشوند. این رفتار همچنین توسط کادر انتخاب «انتشار مجدد خودکار هنگام ایجاد تغییرات» در رابط کاربری Drive کنترل میشود. برای فایلهای Google Sites، publishAuto
همیشه false
است.