REST Resource: revisions

資源:修訂版本

檔案的修訂版本。

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

JSON 表示法
{
  "id": string,
  "mimeType": string,
  "kind": string,
  "published": boolean,
  "etag": string,
  "exportLinks": {
    string: string,
    ...
  },
  "pinned": boolean,
  "md5Checksum": string,
  "modifiedDate": string,
  "lastModifyingUserName": string,
  "downloadUrl": string,
  "publishAuto": boolean,
  "publishedOutsideDomain": boolean,
  "publishedLink": string,
  "fileSize": string,
  "originalFilename": string,
  "lastModifyingUser": {
    object (User)
  },
  "selfLink": string
}
欄位
id

string

僅供輸出。修訂版本的 ID。

mimeType

string

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

kind

string

僅供輸出。一律為 drive#revision

published

boolean

這個修訂版本是否已發布。這項資訊只會填入,且只能針對文件編輯器檔案修改。

etag

string

僅供輸出。修訂版本的 ETag。

pinned

boolean

是否固定這個修訂版本,以免系統自動清除。如果不設定,系統會在上傳新內容 30 天後自動清除修訂版本。這個欄位只能修改儲存在 Google 雲端硬碟中內容的檔案 (文件編輯器檔案除外)。您也可使用固定的查詢參數,透過 drive.files.insert/update/copy 加以固定。固定修訂版本會無限期使用額外儲存空間配額 (最多 200 個) 來儲存。

md5Checksum

string

僅供輸出。此修訂版本內容的 MD5 總和檢查碼。系統只會將含有內容的檔案填入雲端硬碟。

modifiedDate

string

僅供輸出。此修訂版本上次修改的時間 (格式化 RFC 3339 時間戳記)。

lastModifyingUserName

string

僅供輸出。最後一個修改此修訂版本的使用者名稱。

downloadUrl

string

僅供輸出。檔案的短期下載網址。系統只會將含有內容的檔案填入雲端硬碟。

publishAuto

boolean

是否要自動重新發布後續的修訂版本。這項資訊只會填入,且只能針對文件編輯器檔案修改。

publishedOutsideDomain

boolean

這個修訂版本是否在網域外發布。這項資訊只會填入,且只能針對文件編輯器檔案修改。

fileSize

string (int64 format)

僅供輸出。修訂版本的大小 (以位元組為單位)。系統只會將含有內容的檔案填入雲端硬碟。

originalFilename

string

僅供輸出。建立這個修訂版本時的原始檔案名稱。系統只會將含有內容的檔案填入雲端硬碟。

lastModifyingUser

object (User)

僅供輸出。最後一個可以修改這個修訂版本的使用者。

方法

delete

永久刪除檔案版本。

get

取得特定修訂版本。

list

列出檔案的修訂版本。

patch

更新修訂版本。

update

更新修訂版本。