Method: notes.permissions.batchDelete
刪除記事中的一或多項權限。指定的實體會立即失去存取權。無法移除具有「OWNER
」角色的權限。如果移除權限失敗,整個要求都會失敗,也不會做出任何變更。如果記事中沒有指定的權限,則傳回 400 錯誤要求錯誤。
HTTP 要求
POST https://keep.googleapis.com/v1/{parent=notes/*}/permissions:batchDelete
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
parent |
string
所有權限所共用的父項資源。格式:notes/{note} 如果設定這個項目,在 DeletePermissionRequest 訊息中指定的所有權限上層都必須與這個欄位相符。
|
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
{
"names": [
string
]
} |
欄位 |
names[] |
string
必要欄位。要刪除的權限名稱。格式:notes/{note}/permissions/{permission}
|
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/keep
詳情請參閱授權指南。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-09-05 (世界標準時間)。
[null,null,["上次更新時間:2024-09-05 (世界標準時間)。"],[[["This operation allows the deletion of one or more permissions on a note, removing access for the specified entities."],["The request must be sent as a POST request to the specified URL, including the note ID in the path parameter."],["The request body requires a JSON object with an array of permission names to be deleted, formatted as 'notes/{note}/permissions/{permission}'."],["Upon success, the response body will be empty, indicating the permissions have been removed."],["This operation requires authorization with the 'https://www.googleapis.com/auth/keep' scope."]]],[]]