REST Resource: revisions
Stay organized with collections
Save and categorize content based on your preferences.
Resource: Revision
The metadata for a revision to a file.
Some resource methods (such as
revisions.update
) require a
revisionId
. Use the
revisions.list
method to retrieve the ID for a revision.
JSON representation
|
{
"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
)
}
}
|
Fields
|
id
|
string
Output only. The ID of the revision.
|
mimeType
|
string
Output only. The MIME type of the revision.
|
kind
|
string
Output only. Identifies what kind of resource this is. Value: the fixed string
"drive#revision"
.
|
published
|
boolean
Whether this revision is published. This is only applicable to Docs Editors files.
|
exportLinks
|
map (key: string, value: string)
Output only. Links for exporting Docs Editors files to specific formats.
An object containing a list of
"key": value
pairs. Example:
{ "name": "wrench", "mass": "1.3kg", "count": "3" }
.
|
keepForever
|
boolean
Whether to keep this revision forever, even if it is no longer the head revision. If not set, the revision will be automatically purged 30 days after newer content is uploaded. This can be set on a maximum of 200 revisions for a file.
This field is only applicable to files with binary content in Drive.
|
md5Checksum
|
string
Output only. The MD5 checksum of the revision's content. This is only applicable to files with binary content in Drive.
|
modifiedTime
|
string
Output only. The last time the revision was modified (RFC 3339 date-time).
|
publishAuto
|
boolean
Whether subsequent revisions will be automatically republished. This is only applicable to Docs Editors files.
|
publishedOutsideDomain
|
boolean
Whether this revision is published outside the domain. This is only applicable to Docs Editors files.
|
publishedLink
|
string
Output only. A link to the published revision. This is only populated for Google Sites files.
|
size
|
string (
int64
format)
Output only. The size of the revision's content in bytes. This is only applicable to files with binary content in Drive.
|
originalFilename
|
string
Output only. The original filename used to create this revision. This is only applicable to files with binary content in Drive.
|
lastModifyingUser
|
object (
User
)
Output only. The last user to modify this revision.
|
Methods
|
|
Permanently deletes a file version.
|
|
Gets a revision's metadata or content by ID.
|
|
Lists a file's revisions.
|
|
Updates a revision with patch semantics.
|
Except as otherwise noted, the content of this page is licensed under the
Creative Commons Attribution 4.0 License
, and code samples are licensed under the
Apache 2.0 License
. For details, see the
Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-08-09 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Missing the information I need"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Too complicated / too many steps"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Out of date"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Samples / code issue"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]