Updates a revision with patch semantics. Try it now.
Request
HTTP request
PATCH https://www.googleapis.com/drive/v3/files/fileId/revisions/revisionId
Parameters
| Parameter name | Value | Description |
|---|---|---|
| Path parameters | ||
fileId |
string |
The ID of the file. |
revisionId |
string |
The ID of the revision. |
| Optional query parameters | ||
fields |
string |
The paths of the fields you want included in the response. If not specified, the response includes a default set of fields specific to this method. For development you can use the special value * to return all fields, but you'll achieve greater performance by only selecting the fields you need. For more information, see Return specific fields for a file.
|
Authorization
This request requires authorization with at least one of the following scopes:
| Scope |
|---|
https://www.googleapis.com/auth/drive |
https://www.googleapis.com/auth/drive.file |
https://www.googleapis.com/auth/drive.appdata |
Some scopes are restricted and require a security assessment for your app to use them. For more information, see the authentication and authorization page.
Request body
In the request body, supply the relevant portions of a Revisions resource, according to the rules of patch semantics, with the following properties:
| Property name | Value | Description | Notes |
|---|---|---|---|
| Optional Properties | |||
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. |
writable |
publishAuto |
boolean |
Whether subsequent revisions will be automatically republished. This is only applicable to Docs Editors files. | writable |
published |
boolean |
Whether this revision is published. This is only applicable to Docs Editors files. | writable |
publishedOutsideDomain |
boolean |
Whether this revision is published outside the domain. This is only applicable to Docs Editors files. | writable |
Response
If successful, this method returns a Revisions resource in the response body.
Try it!
Use the APIs Explorer below to call this method on live data and see the response.