REST Resource: revisions

資源:修訂版本

檔案修訂版本的中繼資料。

部分資源方法 (例如 revisions.update) 需要 revisionId。使用 revisions.list 方法擷取修訂版本的 ID。

JSON 表示法
{
  "id": string,
  "mimeType": string,
  "kind": string,
  "published": boolean,
  "exportLinks": {
    string: string,
    ...
  },
  "keepForever": boolean,
  "md5Checksum": string,
  "modifiedTime": string,
  "publishAuto": boolean,
  "publishedOutsideDomain": boolean,
  "publishedLink": string,
  "size": string,
  "originalFilename": string,
  "lastModifyingUser": {
    object (User)
  }
}
欄位
id

string

僅供輸出。修訂版本 ID。

mimeType

string

僅供輸出。修訂版本的 MIME 類型。

kind

string

僅供輸出。標示資源的種類。值:固定字串 "drive#revision"

published

boolean

此修訂版本是否已發布。這項功能僅適用於文件編輯器檔案。

keepForever

boolean

是否永久保留這個修訂版本,即使此版本已經不是頭版修訂也一樣。如果不設定這項政策,系統會在上傳新內容的 30 天後自動清除修訂版本。每個檔案最多只能設定 200 個修訂版本。

這個欄位僅適用於雲端硬碟中的二進位內容檔案。

md5Checksum

string

僅供輸出。修訂版本內容的 MD5 總和檢查碼。這種做法僅適用於雲端硬碟中的二進位內容檔案。

modifiedTime

string

僅供輸出。上次修改修訂版本的時間 (RFC 3339 日期時間)。

publishAuto

boolean

是否將後續的修訂版本自動重新發布。這項功能僅適用於文件編輯器檔案。

publishedOutsideDomain

boolean

這個修訂版本是否在網域外發布。這項功能僅適用於文件編輯器檔案。

size

string (int64 format)

僅供輸出。修訂版本內容大小 (以位元組為單位)。這種做法僅適用於雲端硬碟中的二進位內容檔案。

originalFilename

string

僅供輸出。用來建立這個修訂版本的原始檔案名稱。這種做法僅適用於雲端硬碟中的二進位內容檔案。

lastModifyingUser

object (User)

僅供輸出。最後一個修改此修訂版本的使用者。這個欄位只有在上次修改的情況下,是由已登入的使用者執行。

方法

delete

永久刪除檔案版本。

get

根據 ID 取得修訂版本的中繼資料或內容。

list

列出檔案的修訂版本。

update

使用 patch 語意更新修訂版本。