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 中的一个。