本頁面由 Cloud Translation API 翻譯而成。

Method: permissions.create

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

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

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

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

參數

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

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 範圍：

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

Method: permissions.create 透過集合功能整理內容 你可以依據偏好儲存及分類內容。