變更和修訂版本總覽

Google 雲端硬碟會自動記錄修改記錄,協助使用者追蹤檔案變更和內容修訂。使用者可以在修訂版本記錄中查看編輯內容,並將檔案還原到特定版本。

下列術語與 Google Drive API 的變更和修訂版本資源相關:

存取控制清單 (ACL)
與檔案、資料夾或共用雲端硬碟相關聯的所有權限資源清單。
變更
檔案內容或中繼資料的變更,或是檔案或共用雲端硬碟的變更。
使用者變更記錄

使用者在「我的雲端硬碟」中對所有可編輯檔案 (例如 Google 文件、試算表或簡報) 所做的變更記錄。如果是共用雲端硬碟的成員,使用者變更記錄也會包含共用雲端硬碟成員資格、使用者對該共用雲端硬碟中項目的存取層級,以及共用雲端硬碟名稱變更的項目。

共用雲端硬碟變更記錄

共用雲端硬碟的所有變更記錄,例如新增或移除使用者,以及該共用雲端硬碟中所有項目的變更。共用雲端硬碟中項目的變更會同時顯示在使用者變更記錄和共用雲端硬碟變更記錄中。

變更記錄項目

檔案內容或中繼資料的變更記錄,適用於檔案或共用雲端硬碟。變更記錄項目會指出進行變更的使用者、時間戳記和 ID。變更記錄中一次只能顯示一個檔案或共用雲端硬碟的項目。每次檔案或共用雲端硬碟變更時,系統都會為該項目建立新的 ID,並取代先前的項目。

修訂

檔案版本,代表檔案內容 (而非中繼資料) 的變更。您可以使用 Drive API 中的修訂版本資源存取每個修訂版本。

主要修訂版本

檔案的最新版本。

Blob 修訂版本

不可修改的二進位檔案 (例如圖片、影片或 PDF) 版本。如果 blob 修訂版本是二進位檔案的唯一修訂版本,就無法刪除。您可以將新的 blob 上傳為新的修訂版本,該版本會成為檔案的新主要修訂版本。

除了主要修訂版本外,任何未指定為「永久保留」的 Blob 檔案修訂版本都可以清除。可清除的修訂版本通常會保留 30 天,但如果檔案有 100 個未指定為「永久保留」的修訂版本,且上傳了新的修訂版本,系統就會提早清除。

如要進一步瞭解如何將 Blob 修訂版本設為「永久保留」,請參閱「指定要從自動刪除作業中儲存的修訂版本」。

修訂版本記錄

依時間順序記錄檔案的所有修訂版本。如果變更 Google 文件、試算表或簡報檔案,系統會建立新修訂版本。每次內容變更時,雲端硬碟都會為該檔案建立新的修訂版本記錄項目。不過,這些編輯器檔案修訂版本可能會合併,因此 API 回應可能不會顯示檔案的所有變更。