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