Method: permissions.create

• HTTP 要求
• 路徑參數
• 查詢參數
• 要求主體
• 回應主體
• 授權範圍
• 試試看！

為檔案或共用雲端硬碟建立權限。

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

HTTP 要求

POST https://www.googleapis.com/drive/v3/files/{fileId}/permissions

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

路徑參數

參數
fileId	string 檔案或共用雲端硬碟的 ID。

查詢參數

參數
emailMessage	string 要加入通知電子郵件的純文字自訂訊息。
enforceSingleParent (deprecated)	boolean 已淘汰：詳情請參閱 moveToNewOwnersRoot。
moveToNewOwnersRoot	boolean 只有在項目不在共用雲端硬碟中，且要求嘗試轉移項目擁有權時，這個參數才會生效。如果設為 true，系統會將項目移至新擁有者的「我的雲端硬碟」根資料夾，並移除所有先前的上層資料夾。如果設為 false，父項就不會變更。
sendNotificationEmail	boolean 共用給使用者或群組時，是否要傳送通知電子郵件。對於使用者和群組，這項屬性預設為 true，但不允許其他要求使用。但不得停用，否則無法轉移擁有權。
supportsAllDrives	boolean 要求的應用程式是否同時支援「我的雲端硬碟」和共用雲端硬碟。
supportsTeamDrives (deprecated)	boolean 已淘汰：請改用 supportsAllDrives。
transferOwnership	boolean 是否將擁有權轉移給指定使用者，並將目前的擁有者降級為寫入者。這是必要參數，用於確認副作用。
useDomainAdminAccess	boolean 以網域管理員身分提出要求。如果設為 true，當檔案 ID 參數參照共用雲端硬碟，且要求者是共用雲端硬碟所屬網域的管理員時，系統就會授予要求者存取權。
enforceExpansiveAccess	boolean 要求是否應強制執行擴充存取規則。

要求主體

要求主體包含 Permission 的例項。

回應主體

如果成功，回應主體會包含新建立的 Permission 例項。

授權範圍

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

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

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