Method: permissions.create

為檔案或共用雲端硬碟建立權限。詳情請參閱「共用檔案、資料夾和雲端硬碟」。

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

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，且符合下列額外條件，系統就會授予要求者存取權：

  1. 檔案 ID 參數是指共用雲端硬碟。
  2. 要求者是共用雲端硬碟所屬網域的管理員。

詳情請參閱「以網域管理員身分管理共用雲端硬碟」。
enforceExpansiveAccess

boolean

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

要求主體

要求主體包含 Permission 的例項。

回應主體

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

授權範圍

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

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

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