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

更新修订版本。