با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
Google Drive یک تاریخچه خودکار تغییرات را حفظ می کند، که می تواند به کاربران کمک کند تغییرات فایل و بازبینی محتوا را ردیابی کنند. در تاریخچه ویرایش، کاربران می توانند ببینند چه ویرایش هایی انجام شده است و می توانند به نسخه خاصی از یک فایل با ویرایش های خاص برگردند.
شرایط زیر مربوط به تغییرات و منابع تجدید نظر در Google Drive API است:
لیست کنترل دسترسی (ACL)
فهرستی از تمام منابع مجوز مرتبط با یک فایل، پوشه یا درایو مشترک.
تغییر دهید
تغییری که در محتوای فایل یا فراداده یک فایل یا درایو مشترک ایجاد شده است.
گزارش تغییر کاربر
رکوردی از همه تغییراتی که کاربر در هر فایل قابل ویرایش در My Drive خود انجام داده است، مانند Google Docs، Sheets یا Slides. برای اعضای یک درایو مشترک، گزارش تغییرات کاربر همچنین شامل ورودی‌هایی درباره عضویت درایو مشترک، سطوح دسترسی کاربر به موارد موجود در آن درایو مشترک و تغییرات نام درایو مشترک است.
گزارش تغییر درایو مشترک
رکوردی از تمام تغییرات یک درایو مشترک، مانند اضافه یا حذف کاربران، و همه تغییرات در موارد در آن درایو مشترک. تغییر در یک مورد در درایو مشترک هم در گزارش تغییرات کاربر و هم در گزارش تغییر درایو مشترک ظاهر می شود.
تغییر ورودی گزارش
رکوردی از تغییر ایجاد شده در محتوای یک فایل یا ابرداده یک فایل یا درایو مشترک. یک ورودی گزارش تغییرات، کاربری که تغییر را انجام داده، مهر زمانی و یک شناسه را نشان می دهد. در هر بار فقط یک ورودی در هر فایل یا درایو مشترک در گزارش تغییرات وجود دارد. هر بار که آن فایل یا درایو مشترک تغییر می کند، شناسه جدیدی برای آن ورودی ایجاد می شود و جایگزین ورودی قبلی می شود.
تجدید نظر
نسخه ای از فایل که نشان دهنده تغییر در محتویات فایل است (نه ابرداده). هر نسخه را می توان با استفاده از منبع revisions در Drive API مشاهده کرد.
اصلاح سر
جدیدترین نسخه یک فایل. با استفاده از منبع files موجود در Drive API می‌توان به headRevisionId دسترسی پیدا کرد. headRevisionId فقط برای فایل‌های blob در Drive در دسترس است.
بازبینی لکه
نسخه ای از یک فایل باینری غیرقابل تغییر، مانند تصویر، ویدئو یا PDF. اگر ویرایش blob تنها ویرایش فایل باینری باشد، نمی توان آن را حذف کرد. یک حباب جدید را می توان به عنوان یک ویرایش جدید آپلود کرد که تبدیل به ویرایش سر جدید آن فایل می شود.
هر ویرایش فایل blob، به غیر از نسخه اصلی، که به عنوان "برای همیشه نگه دارید" تعیین نشده باشد، قابل پاکسازی است. نسخه‌های قابل پاکسازی معمولاً به مدت 30 روز حفظ می‌شوند، اما اگر فایلی دارای 100 ویرایش باشد که به‌عنوان «برای همیشه نگه دارید» تعیین نشده‌اند و نسخه جدیدی آپلود شود، می‌توان آنها را زودتر پاک کرد.
سابقه تمام بازبینی‌های یک فایل به ترتیب زمانی. تغییر در فایل سندنگار، کاربرگ‌نگار یا اسلایدنگار یک ویرایش جدید دریافت می‌کند. هر بار که محتوا تغییر می کند، Drive یک ورودی تاریخچه ویرایش جدید برای آن فایل ایجاد می کند. با این حال، این ویرایش‌های فایل ویرایشگر ممکن است با هم ادغام شوند، بنابراین پاسخ API ممکن است همه تغییرات یک فایل را نشان ندهد.
تاریخ آخرین بهروزرسانی 2025-08-13 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-13 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Changes and revisions overview\n\nGoogle Drive maintains an automatic history of modifications, which can help\nusers track file changes and content revisions. In the revision history, users\ncan see what edits have been made and can revert to a specific version of a file\nwith specific edits.\n\nThe following terms are relevant to the changes and revisions resources of the\nGoogle Drive API:\n\n*Access Control List (ACL)*\n: The list of all permission resources associated with a file, folder, or shared\n drive.\n\n*Change*\n: An alteration made to a file's content or metadata of a file or shared drive.\n\n*User change log*\n\n: A record of all changes that a user made to every editable file in their My\n Drive, such as a Google Docs, Sheets, or a\n Slides. For members of a shared drive, the user change log\n also includes entries about shared drive membership, user access levels to\n items in that shared drive, and shared drive name changes.\n\n | **Note:** Even if several users can access the same file, not all changes to that file are reflected in every users' change log. For example, when a user opens the file for the first time, or marks the file as Starred, those changes only appear in that users' change log. As another example, when a file's ACL is changed, it's only reflected in the change log of the following users: The file's owner, any service accounts on the ACL, and any users directly impacted by the ACL change.\n\n*Shared drive change log*\n\n: A record of all changes to a shared drive, such as additions or removals of\n users, and all changes to items on that shared drive. A change to an item\n within a shared drive appears in both the *user change log* and shared drive\n change log.\n\n*Change log entry*\n\n: A record of a change made to a file's content or metadata of a file or shared\n drive. A change log entry indicates the user who made the change, the\n timestamp, and an ID. There can only be one entry per file or shared drive\n in the change log at a time. Each time that file or shared drive changes, a\n new ID is created for that entry, and it replaces the previous entry.\n\n*Revision*\n\n: A version of the file representing a change to the file's contents (not\n metadata). Each revision can be accessed using the [`revisions`](/workspace/drive/api/reference/rest/v3/revisions) resource within the Drive API.\n\n*Head revision*\n\n: The most current version of a file. The `headRevisionId` can be accessed using\n the [`files`](/workspace/drive/api/reference/rest/v3/files) resource within the\n Drive API. The `headRevisionId` is only available for blob files\n in Drive.\n\n*Blob revision*\n\n: A version of an unmodifiable binary file, such as an image, video, or PDF. If\n the blob revision is the only revision of the binary file, it cannot be\n deleted. A new blob can be uploaded as a new *revision* , which becomes the\n new *head revision* of that file.\n\n Any blob file revision, other than the head revision, that's not designated\n as \"Keep Forever\" is purgeable. Purgeable revisions are typically preserved\n for 30 days, but can be purged earlier if a file has 100 revisions that\n aren't designated as \"Keep Forever\" and a new revision is uploaded.\n\n For more information on setting blob revisions as \"Keep Forever\", see\n [Specify revisions to save from auto\n delete](/workspace/drive/api/guides/manage-revisions#specify-revisions).\n\n*Revision history*\n\n: A record of all revisions of a file in chronological order. A change to a\n Docs, Sheets, or Slides file\n gets a new revision. Each time the content changes, Drive\n creates a new revision history entry for that file. However, these editor\n file revisions may be merged together, so the API response might not show\n all changes to a file.\n\nRelated topics\n--------------\n\n- To identify where the change you want to track is recorded, see [Identify\n which change log to track](/workspace/drive/api/guides/about-changelogs).\n- To set up change tracking for users and shared drives, see [Track changes\n for users and shared drives](/workspace/drive/api/guides/about-changes).\n- To download a blob file content revision or to export a Google Workspace document content revision, see [Download and export\n files](/workspace/drive/api/guides/manage-downloads).\n- To publish a revision, see [Manage file\n revisions](/workspace/drive/api/guides/manage-revisions).\n- To set up change notifications, see [Notifications for resource changes](/workspace/drive/api/guides/push)."]]
