Method: notes.permissions.batchCreate

创建记事的一项或多项权限。只能创建具有 WRITER 角色的权限。如果添加任何权限失败,则整个请求将会失败,并且不会做出任何更改。

HTTP 请求

POST https://keep.googleapis.com/v1/{parent=notes/*}/permissions:batchCreate

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

创建的所有权限共享的父级资源。格式:notes/{note} 如果设置此参数,CreatePermission 消息中的父字段必须为空或与此字段匹配。

请求正文

请求正文中包含结构如下的数据:

JSON 表示法
{
  "requests": [
    {
      object (CreatePermissionRequest)
    }
  ]
}
字段
requests[]

object (CreatePermissionRequest)

指定要创建的资源的请求消息。

响应正文

对备注创建权限的响应。

如果成功,响应正文将包含结构如下的数据:

JSON 表示法
{
  "permissions": [
    {
      object (Permission)
    }
  ]
}
字段
permissions[]

object (Permission)

已创建权限。

授权范围

需要以下 OAuth 作用域:

  • https://www.googleapis.com/auth/keep

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

创建权限请求

请求为备注添加单个权限。

JSON 表示法
{
  "parent": string,
  "permission": {
    object (Permission)
  }
}
字段
parent

string

必需。将在其中创建此权限的父级备注。格式:notes/{note}

permission

object (Permission)

必需。创建权限。必须提供 Permission.email、User.email 或 Group.email 中的一个。