Method: permissions.create
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
为文件或共享云端硬盘创建权限。
警告:不支持对同一文件执行并发权限操作;系统只会应用最后一次更新。
HTTP 请求
POST https://www.googleapis.com/drive/v3/files/{fileId}/permissions
网址采用 gRPC 转码语法。
路径参数
参数 |
fileId |
string
文件或共享云端硬盘的 ID。
|
查询参数
参数 |
emailMessage |
string
要包含在通知电子邮件中的纯文本自定义消息。
|
enforceSingleParent (deprecated) |
boolean
已弃用:如需了解详情,请参阅 moveToNewOwnersRoot 。
|
moveToNewOwnersRoot |
boolean
仅当相应内容不在共享云端硬盘中,且请求尝试转移该内容的所有权时,此参数才会生效。如果设置为 true ,相应内容将移至新所有者的“我的云端硬盘”根文件夹,并移除所有之前的父文件夹。如果设置为 false ,则不会更改家长。
|
sendNotificationEmail |
boolean
是否在向用户或群组分享时发送通知电子邮件。对于用户和群组,此值默认为 true ,不允许用于其他请求。在转移所有权时,不得停用此功能。
|
supportsAllDrives |
boolean
请求访问的应用是否同时支持“我的云端硬盘”和共享云端硬盘。
|
supportsTeamDrives (deprecated) |
boolean
已弃用:请改用 supportsAllDrives 。
|
transferOwnership |
boolean
是否将所有权转移给指定用户,并将当前所有者降级为写入者。此参数是必需的,用于确认副作用。
|
useDomainAdminAccess |
boolean
以网域管理员身份发出请求;如果设置为 true,则当文件 ID 参数引用的是共享云端硬盘,且请求者是该共享云端硬盘所属网域的管理员时,系统会向请求者授予访问权限。
|
enforceExpansiveAccess |
boolean
相应请求是否应强制执行广泛的访问权限规则。
|
请求正文
请求正文包含一个 Permission
实例。
响应正文
如果成功,响应正文将包含一个新创建的 Permission
实例。
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
某些范围受到限制,您的应用需要通过安全评估才能使用这些范围。如需了解详情,请参阅授权指南。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-27。
[null,null,["最后更新时间 (UTC):2025-08-27。"],[],[],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)."]]