删除记事的一项或多项权限。指定的实体将立即失去访问权限。无法移除具有 OWNER 角色的权限。如果移除权限失败,则整个请求都会失败,并且不会进行任何更改。如果记事中不存在指定的权限,则返回 400 错误“Bad Request”。
HTTP 请求
POST https://keep.googleapis.com/v1/{parent=notes/*}/permissions:batchDelete
网址采用 gRPC 转码语法。
路径参数
| 参数 | |
|---|---|
| parent | 
 所有要删除的权限共享的父级资源。格式: | 
请求正文
请求正文中包含结构如下的数据:
| JSON 表示法 | 
|---|
| { "names": [ string ] } | 
| 字段 | |
|---|---|
| names[] | 
 必需。要删除的权限的名称。格式: | 
响应正文
如果成功,则响应正文为空的 JSON 对象。
授权范围
需要以下 OAuth 范围:
- https://www.googleapis.com/auth/keep
如需了解详情,请参阅授权指南。