Google 雲端硬碟 API 提供 revisions
資源,方便您下載及發布檔案修訂版本。如要進一步瞭解修訂版本的相關術語,請參閱「變更和修訂版本總覽」。
指定要儲存的修訂版本,以免遭到自動刪除
Google 雲端硬碟會自動刪除使用者不再感興趣的舊版修訂版本。如要避免這種情況發生,您可以將布林標記 keepRevisionForever
設為 true
,標示不想讓 Google 雲端硬碟清除的修訂版本。
下載修訂版本
如要下載最新修訂版本,請使用 files.download
方法。詳情請參閱「管理長時間執行的作業」。
發布修訂版本
如要發布 Google 文件、Google 試算表和 Google 簡報修訂版本,請在 revisions
資源中設定該檔案的 published
屬性。您無法使用 Drive API 為 Google Sites 修訂版本設定這個屬性。
Google 簡報和 Google 繪圖不支援發布特定修訂版本。系統只支援自動重新發布最新修訂版本。如要發布簡報和繪圖,請將 publishAuto
設為 true
。
如果檔案是在 Google Workspace 網域中建立,publishedOutsideDomain
屬性會指出修訂版本是否可供任何人存取,或是僅限網域使用者存取。對於 Sites 檔案,此屬性會指出是否存在 type=anyone
權限。
除非設定 publishAuto
屬性,否則發布的修訂版本不會反映對檔案所做的變更。如果該屬性設為 true
,系統會自動發布較新的檔案修訂版本,並覆寫先前的版本。這項行為也會受到雲端硬碟 UI 中「內容有所變更時自動重新發布」核取方塊的控制。投影片和繪圖僅支援自動重新發布,且需要將 publishAuto
屬性設為 true
。對於協作平台檔案,publishAuto
一律是 false
。