為記事建立一或多項權限。只能建立具備「WRITER
」角色的權限。如果新增任何權限失敗,整個要求都會失敗,而且不會做出任何變更。
HTTP 要求
POST https://keep.googleapis.com/v1/{parent=notes/*}/permissions:batchCreate
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
parent |
所建立所有權限共用的父項資源。格式: |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{
"requests": [
{
object ( |
欄位 | |
---|---|
requests[] |
用於指定待建立資源的要求訊息。 |
回應主體
針對記事建立權限的回應。
如果成功,回應主體會含有以下結構的資料:
JSON 表示法 |
---|
{
"permissions": [
{
object ( |
欄位 | |
---|---|
permissions[] |
已建立權限。 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/keep
詳情請參閱授權指南。
CreatePermissionRequest
要求在記事中新增單一權限。
JSON 表示法 |
---|
{
"parent": string,
"permission": {
object ( |
欄位 | |
---|---|
parent |
必要欄位。建立這項權限的父項附註。格式: |
permission |
必要欄位。建立的權限。必須提供 Permission.email、User.email 或 Group.email 其中一個權限。 |