Method: permissions.patch

使用 patch 語義更新權限。

警告：系統不支援在同一個檔案上執行並行的權限作業，只會套用最後一次更新的權限。

HTTP 要求

PATCH https://www.googleapis.com/drive/v2/files/{fileId}/permissions/{permissionId}

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
fileId

string

檔案或共用雲端硬碟的 ID。
permissionId

string

權限的 ID。

查詢參數

參數
removeExpiration

boolean

是否要移除到期日。
supportsAllDrives

boolean

要求的應用程式是否同時支援「我的雲端硬碟」和共用雲端硬碟。
supportsTeamDrives
(deprecated)

boolean

已淘汰：請改用 supportsAllDrives。
transferOwnership

boolean

變更角色為 owner 時，是否會將目前的擁有者降級為作者。如果指定的角色不是 owner，則不會執行任何動作。
useDomainAdminAccess

boolean

以網域管理員身分提出要求；如果設為 true，當檔案 ID 參數參照共用雲端硬碟，且要求者是共用雲端硬碟所屬網域的管理員時，系統就會授予要求者存取權。
enforceExpansiveAccess

boolean

要求是否應強制執行擴充存取規則。

要求主體

要求主體包含 Permission 的例項。

回應主體

如果成功，回應主體會包含 Permission 的執行例項。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file

部分權限受限制，應用程式必須通過安全性評估才能使用。詳情請參閱授權指南。