Google Drive API 提供 revisions 資源，方便您下載及發布檔案修訂版本。如要進一步瞭解修訂版本術語，請參閱變更和修訂版本總覽。
本指南說明如何使用 Google Drive API 管理檔案修訂版本。
指定要從自動刪除中保留的修訂版本
Google 雲端硬碟會自動刪除使用者不再需要的舊版修訂內容。
Blob 檔案修訂版本可以設為「永久保留」，也就是說，系統不會自動清除該修訂版本。最多可將 200 個修訂版本設為「永久保留」，並計入儲存空間用量。系統絕不會自動清除主要修訂版本。
除了主要修訂版本外，任何未指定為「永久保留」的 Blob 檔案修訂版本都可以清除。可清除的修訂版本通常會保留 30 天，但如果檔案有 100 個未指定為「永久保留」的修訂版本，且上傳了新的修訂版本，系統就會提早清除。
您可以將 revisions 資源的布林值 keepForever 欄位設為 true，標示不想讓雲端硬碟清除的版本。將 BLOB 檔案修訂版本設為「永久保留」後，就只能下載或刪除該版本。詳情請參閱「下載修訂版本」或「刪除修訂版本」。
下載修訂版本
您只能下載標示為「永久保存」的 Blob 檔案內容修訂版本。如要下載修訂版本，請務必先將其設為「永久保留」。詳情請參閱「指定要從自動刪除作業中儲存的修訂版本」。
如要下載 Blob 檔案內容修訂版本，或匯出 Google Workspace 文件內容修訂版本，請參閱「下載及匯出檔案」。
刪除修訂版本
即使 Blob 檔案修訂版本標示為「永久保留」，您也可以呼叫 revisions.delete 方法永久刪除該版本。
如果您使用的是舊版 Drive API v2，請改用 revisions 資源的 pinned 欄位。
發布修訂版本
如要發布 Google 文件、Google 試算表和 Google 簡報的修訂版本，請在 revisions 資源中為該檔案設定 published 屬性。使用 Drive API 時，無法為 Google 協作平台修訂版本設定這項屬性。
Google 簡報和 Google 繪圖不支援發布特定修訂版本。系統只支援自動重新發布最新修訂版本。如要發布 Google 簡報和 Google 繪圖，請將 publishAuto 設為 true。
如果檔案是在 Google Workspace 網域中建立，則 publishedOutsideDomain 屬性會指出修訂版本是否可供所有人存取，或僅限網域使用者存取。如果是 Google 協作平台檔案，這項屬性會指出是否存在 type=anyone 權限。詳情請參閱 permissions 資源的 type 欄位。
除非設定 publishAuto 屬性，否則發布的修訂版本不會反映檔案變更。如果將屬性設為 true，系統會自動發布較新的檔案修訂版本，並覆寫先前的版本。簡報和繪圖只支援自動重新發布，且必須將 publishAuto 屬性設為 true。如果是協作平台檔案，publishAuto 一律為 false。
此外，您也可以在 Google 文件和試算表的 UI 中，透過「內容有所變更時自動重新發布」核取方塊，控管自動發布功能。詳情請參閱「公開 Google 文件、試算表、簡報和表單」。