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 語意更新修訂版本。