- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
Inserts a permission for a file or shared drive.
Warning:Concurrent permissions operations on the same file are not supported; only the last update is applied.
HTTP request
POST https://www.googleapis.com/drive/v2/files/{fileId}/permissions
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
fileId
|
The ID for the file or shared drive. |
Query parameters
| Parameters | |
|---|---|
emailMessage
|
A plain text custom message to include in notification emails. |
enforceSingleParent
|
Deprecated: See |
moveToNewOwnersRoot
|
This parameter will only take effect if the item is not in a shared drive and the request is attempting to transfer the ownership of the item. If set to |
sendNotificationEmails
|
Whether to send notification emails when sharing to users or groups. This parameter is ignored and an email is sent if the |
supportsAllDrives
|
Whether the requesting application supports both My Drives and shared drives. |
supportsTeamDrives
|
Deprecated: Use |
useDomainAdminAccess
|
Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs. |
enforceExpansiveAccess
|
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 a newly created instance of Permission
.
Authorization scopes
Requires one of the following OAuth scopes:
-
https://www.googleapis.com/auth/docs -
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 .
