REST Resource: revisions

資源：修訂版本

檔案的修訂版本。

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

JSON 表示法 
{
  "exportLinks": {
    string: string,
    ...
  },
  "id": string,
  "mimeType": string,
  "kind": string,
  "published": boolean,
  "etag": 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

這個修訂版本是否已發布。這項資料只會填入 Google 文件編輯器檔案，且只能修改這類檔案。
etag

string

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

boolean

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

string

僅供輸出。這個修訂版本的內容 MD5 檢查碼。只有儲存在雲端硬碟中的檔案內容才會顯示這項資訊。
modifiedDate

string

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

string

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

string

僅供輸出。檔案的短期下載網址。只有儲存在雲端硬碟中的檔案內容才會顯示這項資訊。
publishAuto

boolean

後續修訂版本是否會自動重新發布。這項資料只會填入 Google 文件編輯器檔案，且只能修改這類檔案。
publishedOutsideDomain

boolean

這個修訂版本是否發布至網域外部。這項資料只會填入 Google 文件編輯器檔案，且只能修改這類檔案。
fileSize

string (int64 format)

僅供輸出。修訂版本的大小 (以位元組為單位)。只有儲存在雲端硬碟中的檔案內容才會顯示這項資訊。
originalFilename

string

僅供輸出。建立這個修訂版本時的原始檔案名稱。只有儲存在雲端硬碟中的檔案內容才會顯示這項資訊。
lastModifyingUser

object (User)

僅供輸出。上次修改這個修訂版本的使用者。只有在上次修改是由已登入的使用者執行時，系統才會填寫這個欄位。

方法

delete

 永久刪除檔案版本。

get

 取得特定修訂版本。

list

 列出檔案的修訂版本。

patch

 更新修訂版本。

update

 更新修訂版本。