Google Drive API 提供 Revisions 資源,可讓您下載及發布檔案修訂版本。如要進一步瞭解修訂版本相關術語,請參閱異動與修訂版本總覽。
指定要自動刪除的修訂版本
Google 雲端硬碟會自動刪除不再需要的舊修訂版本。如要避免這種情況發生,您可以將布林標記 keepRevisionForever
設為 true
,藉此標示您不想讓雲端硬碟清除的修訂版本。
下載修訂版本
您可以使用 Files 資源中的 headRevisionId
欄位值來下載最新的修訂版本。
這會擷取與先前擷取檔案中繼資料相對應的修訂版本。如要下載仍儲存在雲端的所有舊檔案資料,請呼叫 revisions.list
以取得所有修訂版本 ID。
如要下載修訂版本內容,您必須使用參數 alt=media
呼叫 revisions.get
方法。無法下載 Google 文件、試算表和簡報的修訂版本。
Google 文件、Google 繪圖和簡報的修訂版本會自動增加修訂版本編號。不過,如果修訂版本刪除了,由於一連串的數字有缺漏,因此您不應在擷取修訂版本時使用連續號碼。
發布修訂版本
如要發布 Google 文件、試算表和簡報的修訂版本,請在「修訂版本」屬性中設定該檔案的 published
屬性。您無法透過 Drive API 設定 Google 協作平台的修訂版本。
如果檔案是在 Google Workspace 網域中建立,publishedOutsideDomain
屬性會指出任何人皆可存取修訂版本,還是只有網域使用者可存取該修訂版本。如果是 Google 協作平台檔案,此屬性表示是否存在 type=anyone
權限。
除非已設定 publishAuto
屬性,否則修訂的修訂版本不會反映對檔案所做的變更。如果該屬性設定為 true,系統將自動發布檔案的較新修訂版本,並覆寫先前的修訂版本。您也可以使用雲端硬碟 UI 的 [執行變更時自動重新發布] 核取方塊來控制這項行為。對於 Google 協作平台檔案,publishAuto
一律為 false
。