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

如需了解详情,请参阅授权指南