Method: permissions.create
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Создает разрешение для файла или общего диска.
Внимание: одновременные операции с разрешениями для одного и того же файла не поддерживаются; применяется только последнее обновление.
HTTP-запрос
POST https://www.googleapis.com/drive/v3/files/{fileId}/permissions
URL использует синтаксис перекодировки gRPC .
Параметры пути
| Параметры |
|---|
fileId | string Идентификатор файла или общего диска. |
Параметры запроса
| Параметры |
|---|
emailMessage | string Простое текстовое сообщение, которое будет включено в электронное письмо с уведомлением. |
enforceSingleParent
(deprecated) | boolean Устарело: подробности см. в moveToNewOwnersRoot . |
moveToNewOwnersRoot | boolean Этот параметр вступит в силу только в том случае, если объект не находится на общем диске и запрос пытается передать право собственности на него. Если установлено значение true , объект будет перемещен в корневую папку «Мой диск» нового владельца, а все предыдущие родительские элементы будут удалены. Если установлено значение false , родительские элементы не будут изменены. |
sendNotificationEmail | boolean Отправлять ли уведомление по электронной почте при предоставлении доступа пользователям или группам. Значение по true для пользователей и групп и не разрешено для других запросов. Отключать отправку уведомления при передаче прав собственности нельзя. |
supportsAllDrives | boolean Поддерживает ли запрашивающее приложение как «Мои диски», так и общие диски. |
supportsTeamDrives
(deprecated) | boolean Устарело: вместо этого используйте supportsAllDrives . |
transferOwnership | boolean Передать ли владение указанному пользователю и понизить текущего владельца до уровня писателя. Этот параметр необходим для подтверждения побочного эффекта. |
useDomainAdminAccess | boolean Выполните запрос от имени администратора домена. Если установлено значение true, то запрашивающей стороне будет предоставлен доступ, если параметр идентификатора файла относится к общему диску, а запрашивающая сторона является администратором домена, к которому принадлежит общий диск. |
enforceExpansiveAccess | boolean Должен ли запрос предусматривать расширенные правила доступа. |
Текст запроса
Тело запроса содержит экземпляр Permission .
Тело ответа
В случае успеха тело ответа содержит вновь созданный экземпляр Permission .
Области авторизации
Требуется одна из следующих областей OAuth:
-
https://www.googleapis.com/auth/drive -
https://www.googleapis.com/auth/drive.file
Некоторые области действия ограничены, и для их использования вашему приложению требуется оценка безопасности. Подробнее см. в руководстве по авторизации .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-26 UTC.
[null,null,["Последнее обновление: 2025-08-26 UTC."],[],[],null,["# Method: permissions.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a permission for a file or shared drive.\n\n**Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.\n\n### HTTP request\n\n`POST https://www.googleapis.com/drive/v3/files/{fileId}/permissions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|----------------------------------------------|\n| `fileId` | `string` The ID of the file or shared drive. |\n\n### Query parameters\n\n| Parameters ||\n|----------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `emailMessage` | `string` A plain text custom message to include in the notification email. |\n| `enforceSingleParent` **(deprecated)** | `boolean` Deprecated: See `moveToNewOwnersRoot` for details. |\n| `moveToNewOwnersRoot` | `boolean` 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 `true`, the item will be moved to the new owner's My Drive root folder and all prior parents removed. If set to `false`, parents are not changed. |\n| `sendNotificationEmail` | `boolean` Whether to send a notification email when sharing to users or groups. This defaults to true for users and groups, and is not allowed for other requests. It must not be disabled for ownership transfers. |\n| `supportsAllDrives` | `boolean` Whether the requesting application supports both My Drives and shared drives. |\n| `supportsTeamDrives` **(deprecated)** | `boolean` Deprecated: Use `supportsAllDrives` instead. |\n| `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. |\n| `useDomainAdminAccess` | `boolean` 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. |\n| `enforceExpansiveAccess` | `boolean` Whether the request should enforce expansive access rules. |\n\n### Request body\n\nThe request body contains an instance of [Permission](/workspace/drive/api/reference/rest/v3/permissions#Permission).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Permission](/workspace/drive/api/reference/rest/v3/permissions#Permission).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.file`\n\nSome scopes are restricted and require a security assessment for your app to use them. For more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
