- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
Updates a permission with patch semantics. For more information, see Share files, folders, and drives .
Warning:Concurrent permissions operations on the same file aren't supported; only the last update is applied.
HTTP request
PATCH https://www.googleapis.com/drive/v3/files/{fileId}/permissions/{permissionId}
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
fileId
|
The ID of the file or shared drive. |
permissionId
|
The ID of the permission. |
Query parameters
removeExpiration
boolean
Whether to remove the expiration date.
supportsAllDrives
boolean
Whether the requesting application supports both My Drives and shared drives.
supportsTeamDrives
(deprecated)
boolean
Deprecated: Use supportsAllDrives
instead.
transferOwnership
boolean
Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect. For more information, see Transfer file ownership .
useDomainAdminAccess
boolean
Issue the request as a domain administrator.
If set to true
, and if the following additional conditions are met, the requester is granted access:
- The file ID parameter refers to a shared drive.
- The requester is an administrator of the domain to which the shared drive belongs.
For more information, see Manage shared drives as domain administrators .
enforceExpansiveAccess
boolean
Whether the request should enforce expansive access rules.
Request body
The request body contains an instance of Permission
.
Response body
If successful, the response body contains an instance of Permission
.
Authorization scopes
Requires one of the following OAuth scopes:
-
https://www.googleapis.com/auth/drive -
https://www.googleapis.com/auth/drive.file
Some scopes are restricted and require a security assessment for your app to use them. For more information, see the Authorization guide .
