为文件或共享云端硬盘创建权限。
警告：不支持对同一文件执行并发权限操作；系统只会应用最后一次更新。
HTTP 请求
POST https://www.googleapis.com/drive/v3/files/{fileId}/permissions
网址采用 gRPC 转码语法。
路径参数
| 参数 | |
|---|---|
fileId |
文件或共享云端硬盘的 ID。 |
查询参数
| 参数 | |
|---|---|
emailMessage |
要包含在通知电子邮件中的纯文本自定义消息。 |
enforceSingleParent |
已弃用：如需了解详情，请参阅 |
moveToNewOwnersRoot |
仅当相应内容不在共享云端硬盘中，且请求尝试转移该内容的所有权时，此参数才会生效。如果设置为 |
sendNotificationEmail |
是否在向用户或群组分享时发送通知电子邮件。对于用户和群组，此值默认为 |
supportsAllDrives |
请求访问的应用是否同时支持“我的云端硬盘”和共享云端硬盘。 |
supportsTeamDrives |
已弃用：请改用 |
transferOwnership |
是否将所有权转移给指定用户，并将当前所有者降级为写入者。此参数是必需的，用于确认副作用。 |
useDomainAdminAccess |
以网域管理员身份发出请求；如果设置为 true，则当文件 ID 参数引用的是共享云端硬盘，且请求者是该共享云端硬盘所属网域的管理员时，系统会向请求者授予访问权限。 |
enforceExpansiveAccess |
相应请求是否应强制执行广泛的访问权限规则。 |
请求正文
请求正文包含一个 Permission 实例。
响应正文
如果成功，响应正文将包含一个新创建的 Permission 实例。
授权范围
需要以下 OAuth 范围之一：
https://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.file
某些范围受到限制，您的应用需要通过安全评估才能使用这些范围。如需了解详情，请参阅授权指南。