下載及發布檔案修訂版本

Google Drive API 提供修訂版本資源,方便您下載及發布檔案修訂版本。如要進一步瞭解修訂版本術語,請參閱「變更及修訂版本總覽」。

指定要自動刪除哪些修訂版本

Google 雲端硬碟會自動刪除使用者不感興趣的舊修訂版本。如要避免發生這種情形,您可以將布林值標記 keepRevisionForever 設為 true,藉此標示不想讓雲端硬碟清除的修訂版本。

下載修訂版本

您可以使用檔案資源中的 headRevisionId 欄位值,下載最新的修訂版本。這會擷取與先前擷取檔案中繼資料相對應的修訂版本。如要針對仍儲存在雲端的檔案,下載先前的所有修訂版本資料,您可以呼叫 revisions.list,藉此取得所有修訂版本 Id。

如要下載修訂版本內容,您必須使用參數 alt=media 呼叫 revisions.get 方法。無法下載 Google 文件、試算表和簡報的修訂版本。

Google 文件、Google 繪圖和簡報修訂版本會自動增加修訂版本編號。但刪除修訂版本時,一串數字可能會有缺漏,因此擷取修訂版本時不應仰賴序號。

發布修訂版本

如要發布 Google 文件、試算表和簡報修訂版本,您可以在「修訂版本」屬性中設定該檔案的 published 屬性。您無法透過 Drive API 為 Google 協作平台修訂版本設定這項屬性。

如果檔案是在 Google Workspace 網域中建立,publishedOutsideDomain 屬性會指出該修訂版本是否開放所有人存取,或僅限網域使用者存取。如果是 Google 協作平台檔案,這個屬性可指出是否擁有 type=anyone 權限。

除非設定 publishAuto 屬性,否則已發布的修訂版本不會反映檔案變更。如果將這個屬性設為 True,系統就會自動發布較新的檔案修訂版本,並覆寫先前的檔案。此外,系統會透過雲端硬碟使用者介面中的 [內容有所變更時自動重新發布] 核取方塊,控制這項作業。Google 協作平台檔案publishAuto一律為 false