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

有关详情,请参阅授权指南