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 天後自動清除修訂版本。這個欄位只能針對雲端硬碟中儲存的檔案 (不包括文件編輯器檔案) 修改。您在透過 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

更新修訂版本。