變更和修訂版本總覽

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

下列條款與 Google Drive API 的異動和修訂版本資源相關:

存取控制清單 (ACL)
與檔案、資料夾或共用雲端硬碟相關聯的所有權限資源清單。
變更
修改檔案或共用雲端硬碟的內容或中繼資料。
使用者變更記錄
使用者對「我的雲端硬碟」中每個可編輯的檔案 (例如 Google 文件、試算表或簡報) 所做的所有變更記錄。針對共用雲端硬碟成員,使用者變更記錄也會包含共用雲端硬碟成員資格、該共用雲端硬碟中項目的使用者存取層級,以及共用雲端硬碟名稱異動項目。
共用雲端硬碟變更記錄
共用雲端硬碟所有變更的記錄,例如新增或移除使用者,以及該共用雲端硬碟中項目的所有變更。使用者對共用雲端硬碟中的某個項目所做的變更會同時顯示在使用者的變更記錄和共用雲端硬碟變更記錄中。
變更記錄項目
對檔案或共用雲端硬碟的檔案內容或中繼資料所做的變更記錄。變更記錄項目代表做出變更的使用者、時間戳記和 ID。在變更記錄中,每個檔案或共用雲端硬碟一次只能有一個項目。每次變更檔案或共用雲端硬碟時,系統都會為該項目建立新 ID,並取代先前的項目。
修訂版本
代表檔案內容 (而非中繼資料) 變更的檔案版本。每個修訂版本都可以使用 Drive API 中的修訂版本資源存取。
主要修訂版本
最新版本的檔案。
Blob 修訂版本

無法修改的二進位檔案版本,例如圖片、影片或 PDF。如果 blob 修訂版本是二進位檔案的唯一修訂版本,則無法刪除。新的 blob 可上傳為新的修訂版本,做為該檔案的新修訂版本。

Blob 修訂版本可設為「Keep Forever」,代表該修訂版本無法自動清除。最多可以將 200 個修訂版本設為「永久保存」。系統一律不會自動清除預先修訂版本。

任何未指定為「永久保存」的修訂版本都會清除。可清除的修訂版本通常會保留 30 天,但如果檔案有 100 個修訂版本未標示為「Keep Forever」,且已上傳新的修訂版本,就可能會將其清除。

Revisions 資源的 keepForever 欄位可用來將修訂版本設為「Keep Forever」。此外,您可以呼叫 revisions.delete 來刪除修訂版本,即使該修訂版本標示為「Keep Forever」也一樣。

修訂版本記錄

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

請觀看這部影片,瞭解如何使用 Google Drive API 管理修訂版本:

後續步驟