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

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

CreatePermissionRequest

请求对记事添加一项权限。

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

string

必需。要创建此权限的父级备注。格式：notes/{note}
permission

object (Permission)

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