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

這個修訂版本是否已發布。這項屬性僅會填入，且只能修改 Google 文件編輯器檔案。
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

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

boolean

這個修訂版本是否已發布至網域外。這項屬性只會在 Google 文件編輯器檔案中填入，也只能在該類檔案中修改。
fileSize

string (int64 format)

僅供輸出。修訂版本的大小 (以位元組為單位)。只有儲存內容於雲端硬碟的檔案才會填入這項屬性。
originalFilename

string

僅供輸出。建立此修訂版本時的原始檔案名稱。只有儲存內容於雲端硬碟的檔案才會填入這項屬性。
lastModifyingUser

object (User)

僅供輸出。上次修改此修訂版本的使用者。只有在登入使用者上次修改時，這個欄位才會填入資料。

方法

delete

 永久刪除檔案版本。

get

 取得特定修訂版本。

list

 列出檔案的修訂版本。

patch

 更新修訂版本。

update

 更新修訂版本。