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

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

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

Google Drive به‌طور خودکار نسخه‌های قدیمی‌تری را که دیگر برای کاربر جالب نیستند حذف می‌کند. برای جلوگیری از این اتفاق، می‌توانید پرچم بولین keepRevisionForever روی true تنظیم کنید تا نسخه‌هایی را که نمی‌خواهید Drive پاک کند علامت‌گذاری کنید.

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

می توانید از مقدار فیلد headRevisionId از منبع Files برای دانلود آخرین نسخه استفاده کنید. این ویرایشی را واکشی می کند که با فراداده فایلی که قبلاً بازیابی کرده اید مطابقت دارد. برای دانلود داده‌های تمام نسخه‌های قبلی فایل که هنوز در فضای ابری ذخیره می‌شوند، می‌توانید revisions.list فراخوانی کنید، که همه revisionIds را دریافت می‌کند.

توجه: دسترسی به بازبینی‌های تاریخی بر اساس نقش محدود است. قبل از تلاش برای دسترسی، قسمت capabilities.canReadRevisions را در فایل بررسی کنید.

برای دانلود محتوای ویرایش، باید متد revisions.get را با پارامتر alt=media فراخوانی کنید. ویرایش‌های Google Docs، Sheets و Slides را نمی‌توان دانلود کرد.

توجه: اگر از Drive API نسخه 2 قدیمی‌تر استفاده می‌کنید، باید یک درخواست GET مجاز به ویژگی downloadUrl آن ارسال کنید. Google Drive این URL کوتاه مدت را هنگامی که درخواست تجدید نظر می کنید ایجاد می کند — برای استفاده بعدی به آن اعتماد نکنید. همچنین می‌توانید با بررسی ویژگی exportLinks ویرایش را در یکی از قالب‌های پشتیبانی شده صادر کنید.

ویرایش‌های 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 است.