Google Drive API 提供修訂版本資源,可讓您下載及發布檔案修訂版本。如要進一步瞭解修訂版本術語,請參閱變更與修訂版本總覽。
指定要從自動刪除時儲存的修訂版本
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,系統會自動發布較新的檔案修訂版本,並覆寫先前的修訂版本。雲端硬碟使用者介面中的 [內容有所變更時自動重新發布] 核取方塊也會控制這項行為。Google 協作平台檔案的 publishAuto
一律為 false
。