Method: notes.permissions.batchDelete
删除针对记事的一项或多项权限。指定的实体将立即失去访问权限。无法移除具有 OWNER
角色的权限。如果移除某项权限失败,则整个请求都会失败,且不会进行任何更改。如果备注中不存在指定权限,则返回 400 错误请求错误。
HTTP 请求
POST https://keep.googleapis.com/v1/{parent=notes/*}/permissions:batchDelete
网址采用 gRPC 转码语法。
路径参数
参数 |
parent |
string
正在删除的所有权限共享的父级资源。格式:notes/{note} 如果设置此字段,则 DeletePermissionRequest 消息中指定的所有权限的父级都必须与此字段匹配。
|
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
{
"names": [
string
]
} |
字段 |
names[] |
string
必需。要删除的权限的名称。格式:notes/{note}/permissions/{permission}
|
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/keep
有关详情,请参阅授权指南。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-09-05。
[null,null,["最后更新时间 (UTC):2024-09-05。"],[[["This operation allows the deletion of one or more permissions on a note, removing access for the specified entities."],["The request must be sent as a POST request to the specified URL, including the note ID in the path parameter."],["The request body requires a JSON object with an array of permission names to be deleted, formatted as 'notes/{note}/permissions/{permission}'."],["Upon success, the response body will be empty, indicating the permissions have been removed."],["This operation requires authorization with the 'https://www.googleapis.com/auth/keep' scope."]]],[]]