下載及發布檔案修訂版本

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

指定要從自動刪除保留的修訂版本

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

下載修訂版本

您可以使用 Files 資源中的 headRevisionId 欄位值來下載最新修訂版本。 即可擷取與先前擷取檔案中繼資料相對應的修訂版本。如要下載存放於雲端的檔案所有先前修訂版本的資料,您可以呼叫 revisions.list 以取得所有修訂版本 ID。

如要下載修訂版本內容,請 revisions.get 方法,其中含有 alt=media 參數。無法下載 Google 文件、試算表和簡報的修訂版本。

Google 文件、Google 繪圖和簡報的修訂版本會自動遞增編號。不過,如果刪除修訂版本,一串數字可能會有落差,因此,擷取修訂版本時不應仰賴序號。

發布修訂版本

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

如果檔案是在 Google Workspace 網域中建立, publishedOutsideDomain 屬性會指出修訂版本是否為 可供任何人存取,或僅限網域內的使用者存取。Google 專用 協作平台檔案時,這個屬性會指出是否存在 type=anyone 權限。

除非已設定 publishAuto 屬性,否則已發布的修訂版本不會反映檔案變更。如果將這個屬性設為 True,系統會自動發布檔案較新的修訂版本,並覆寫先前的版本。此外,「內容有變更時自動重新發布」也會控制這個行為。核取方塊。對於 Google 協作平台檔案,publishAuto 一律為 false