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 Drive API 管理修訂版本:
後續步驟
- 如要瞭解要追蹤的變更記錄位置,請參閱「找出要追蹤的變更記錄」。
- 如要為使用者和共用雲端硬碟設定變更追蹤功能,請參閱「追蹤使用者和共用雲端硬碟的變更」。
- 如要發布、下載或查詢修訂版本,請參閱「下載及發布檔案修訂版本」。
- 如要設定變更通知,請參閱「推播通知」。