使用修補語意更新權限。立即試用。
要求
HTTP 要求
PATCH https://www.googleapis.com/drive/v3/files/fileId/permissions/permissionId
參數
| 參數名稱 | 值 | 說明 |
|---|---|---|
| 路徑參數 | ||
fileId |
string |
檔案或共用雲端硬碟的 ID。 |
permissionId |
string |
權限 ID。 |
| 選用查詢參數 | ||
fields |
string |
您要在回應中加入的欄位路徑。如未指定，回應會包含這個方法專屬的一組預設欄位。在開發方面，您可以使用特殊值 * 傳回所有欄位，但僅選取您需要的欄位，就能提升成效。詳情請參閱傳回檔案的特定欄位。
|
removeExpiration |
boolean |
是否要移除到期日。
(預設：false)
|
supportsAllDrives |
boolean |
提出要求的應用程式同時支援「我的雲端硬碟」和共用雲端硬碟。
(預設：false)
|
supportsTeamDrives |
boolean |
淘汰了 supportAllDrives。
(預設：false)
|
transferOwnership |
boolean |
是否要將擁有權轉移給指定使用者，並將目前的擁有者降級為寫入者。此參數是確認副作用的必要條件。檔案擁有者只能轉移「我的雲端硬碟」中現有檔案的擁有權。共用雲端硬碟中擁有的檔案是由擁有該共用雲端硬碟的機構所有。共用雲端硬碟中的檔案和資料夾不支援擁有權轉移。共用雲端硬碟的管理者可以將共用雲端硬碟中的項目移至「我的雲端硬碟」，將擁有權轉移給他們。
(預設：false)
|
useDomainAdminAccess |
boolean |
以網域管理員的身分發出要求；如果設為 true，如果檔案 ID 參數參照的是共用雲端硬碟，且要求者是共用雲端硬碟所屬網域的管理員，則要求者將獲得存取權。
(預設：false)
|
授權
此要求需要至少具備下列其中一個範圍的授權：
| 範圍 |
|---|
https://www.googleapis.com/auth/drive |
https://www.googleapis.com/auth/drive.file |
部分範圍會受到限制，需要應用程式進行安全性評估才能使用。詳情請參閱驗證和授權頁面。
要求主體
在要求主體中，根據修補程式語意的規則提供權限資源的相關部分，並提供以下屬性：
| 資源名稱 | 值 | 說明 | Notes |
|---|---|---|---|
| 選填屬性 | |||
expirationTime |
datetime |
權限到期的時間 (RFC 3339 日期時間)。到期時間有下列限制：
|
可寫入 |
pendingOwner |
boolean |
與此權限相關聯的帳戶是否為待審核的擁有者。系統只會針對非共用雲端硬碟中的檔案填入 user 類型權限。 |
可寫入 |
role |
string |
授予此角色的角色。目前我們可能支援新值，但目前允許下列值：
|
可寫入 |
view |
string |
表示這項權限的檢視畫面。只有屬於檢視畫面的權限才會填入資料。published 是唯一支援的值。 |
可寫入 |
回應
如果成功，此方法會在回應主體中傳回 Permissions 資源。
試試看！
使用 APIs Explorer 針對即時資料呼叫這個方法，並查看回應。