變更和修訂版本總覽

Google 雲端硬碟會自動保留修改記錄,方便使用者追蹤檔案變更和內容修訂。在修訂版本記錄中,使用者可以查看已進行的編輯內容,並還原至包含特定編輯內容的檔案版本。

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

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

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

Blob 修訂版本可設為「永久保留」,表示系統無法自動清除修訂版本。最多可將 200 個修訂版本設為「永久保存」。主修訂版本一律不會自動清除。

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

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

修訂版本記錄

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

歡迎觀看這部影片,瞭解如何使用 Google 雲端硬碟 API 管理修訂版本:

後續步驟