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 其中之一。