Method: permissions.delete
刪除權限。
警告:系統不支援在同一個檔案上執行並行的權限作業,只會套用最後一次更新的權限。
HTTP 要求
DELETE https://www.googleapis.com/drive/v3/files/{fileId}/permissions/{permissionId}
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
fileId |
string
檔案或共用雲端硬碟的 ID。
|
permissionId |
string
權限的 ID。
|
查詢參數
參數 |
supportsAllDrives |
boolean
要求的應用程式是否同時支援「我的雲端硬碟」和共用雲端硬碟。
|
supportsTeamDrives (deprecated) |
boolean
已淘汰:請改用 supportsAllDrives 。
|
useDomainAdminAccess |
boolean
以網域管理員身分提出要求;如果設為 true,當檔案 ID 參數參照共用雲端硬碟,且要求者是共用雲端硬碟所屬網域的管理員時,系統就會授予要求者存取權。
|
enforceExpansiveAccess |
boolean
要求是否應強制執行擴充存取規則。
|
回應主體
如果成功,回應主體會是空的 JSON 物件。
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
部分權限受限制,應用程式必須通過安全性評估才能使用。詳情請參閱授權指南。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-02-27 (世界標準時間)。
[null,null,["上次更新時間:2025-02-27 (世界標準時間)。"],[[["This document outlines the process for deleting a permission for a file or shared drive using the Google Drive API."],["The request requires specifying the `fileId` and `permissionId` as path parameters and can optionally include query parameters like `supportsAllDrives` and `useDomainAdminAccess`."],["The request body should be empty, and upon successful deletion, the response body will also be empty."],["Authorization is required using one of the specified OAuth scopes, which might require security assessment for restricted ones."],["Concurrent permission operations are not recommended as only the last update will be applied."]]],["This document outlines the process for deleting a permission associated with a file or shared drive. The core action is a `DELETE` HTTP request to a specified URL, including `fileId` and `permissionId` as path parameters. The request body must be empty. Optional query parameters, like `supportsAllDrives` and `useDomainAdminAccess`, modify the request's behavior. Successful deletion yields an empty JSON response. It is noted that concurrent operations on the same file are unsupported. The document list the needed Authorization scopes.\n"]]