建立檔案或共用雲端硬碟的權限。
警告:您無法對同一個檔案同時執行權限操作,系統只會套用上次更新。
HTTP 要求
POST https://www.googleapis.com/drive/v3/files/{fileId}/permissions
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
fileId |
檔案或共用雲端硬碟的 ID。 |
查詢參數
參數 | |
---|---|
emailMessage |
要加入通知電子郵件中的純文字自訂訊息。 |
enforceSingleParent |
已淘汰:詳情請參閱 |
moveToNewOwnersRoot |
只有在該項目不在共用雲端硬碟中,且要求嘗試轉移項目的擁有權時,這個參數才會生效。如果設為「 |
sendNotificationEmail |
決定是否要向使用者或群組共用檔案時,是否傳送通知電子郵件。對使用者和群組來說,此設定會預設為 true,其他要求則一律禁止。不得為擁有權轉移停用該功能。 |
supportsAllDrives |
提出要求的應用程式是否支援「我的雲端硬碟」和共用雲端硬碟。 |
supportsTeamDrives |
已淘汰:請改用 |
transferOwnership |
是否要將擁有權轉移給指定使用者,並將目前擁有者降級為寫入者。這個參數是為了確認副作用, |
useDomainAdminAccess |
以網域管理員的身分發出要求。如果設為 True,如果檔案 ID 參數參照共用雲端硬碟,而要求者是共用雲端硬碟所屬網域的管理員,要求者就能授予存取權。 |
要求主體
要求主體包含 Permission
的例項。
回應主體
如果成功,回應主體會包含新建立的 Permission
例項。
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
部分範圍受到限制,應用程式必須進行安全性評估,才能使用這些範圍。詳情請參閱授權指南。