資源:權限
檔案的權限。使用者、群組、網域或全球都能存取檔案或資料夾的階層。
部分資源方法 (例如 permissions.update
) 需要 permissionId
。使用 permissions.list
方法擷取檔案、資料夾或共用雲端硬碟的 ID。
JSON 表示法 |
---|
{ "id": string, "displayName": string, "type": string, "kind": string, "permissionDetails": [ { "permissionType": string, "inheritedFrom": string, "role": string, "inherited": boolean } ], "photoLink": string, "emailAddress": string, "role": string, "allowFileDiscovery": boolean, "domain": string, "expirationTime": string, "teamDrivePermissionDetails": [ { "teamDrivePermissionType": string, "inheritedFrom": string, "role": string, "inherited": boolean } ], "deleted": boolean, "view": string, "pendingOwner": boolean } |
欄位 | |
---|---|
id |
僅供輸出。這項權限的 ID。這是授予對象的專屬 ID,並以 |
displayName |
僅供輸出。「美化」權限值的名稱。以下列出每種權限類型的範例:
|
type |
授予對象的類型。有效值如下:
如果 |
kind |
僅供輸出。標示資源的種類。值:固定字串 |
permissionDetails[] |
僅供輸出。詳細說明這個共用雲端硬碟項目的權限是沿用設定,還是直接套用至這個項目。這個僅輸出欄位,僅適用於共用雲端硬碟項目。 |
permissionDetails[].permissionType |
僅供輸出。這位使用者的權限類型,雖然日後可能會加入新值,目前還有下列幾種:
|
permissionDetails[].inheritedFrom |
僅供輸出。繼承這項權限的項目 ID。這是一個僅限輸出的欄位。 |
permissionDetails[].role |
僅供輸出。這位使用者的主要角色,雖然日後可能會加入新值,目前還有下列幾種:
|
permissionDetails[].inherited |
僅供輸出。是否沿用這項權限。系統會一律在這個欄位填入資料。這是一個僅限輸出的欄位。 |
photoLink |
僅供輸出。使用者個人資料相片的連結 (如有)。 |
emailAddress |
這個權限參照的使用者或群組的電子郵件地址。 |
role |
這個權限授予的角色。我們日後可能會支援新的值,但目前允許下列值:
|
allowFileDiscovery |
權限是否允許使用者透過搜尋功能找到檔案。這僅適用於 |
domain |
這項權限參照的網域。 |
expirationTime |
這項權限的效期 (RFC 3339 日期時間)。到期時間具有以下限制:
|
teamDrivePermissionDetails[] |
僅供輸出。已淘汰:僅限輸出。請改用 |
teamDrivePermissionDetails[] |
已淘汰:僅限輸出。請改用 |
teamDrivePermissionDetails[] |
已淘汰:僅限輸出。請改用 |
teamDrivePermissionDetails[] |
已淘汰:僅限輸出。請改用 |
teamDrivePermissionDetails[] |
已淘汰:僅限輸出。請改用 |
deleted |
僅供輸出。與這項權限相關聯的帳戶是否已刪除。這個欄位僅適用於使用者和群組權限。 |
view |
指出這項權限的檢視畫面。只會針對屬於資料檢視的權限填入資料。「published」是唯一支援的值。 |
pendingOwner |
與這項權限連結的帳戶是否為待處理擁有者。僅針對非共用雲端硬碟中的檔案填入 |
方法 |
|
---|---|
|
為檔案或共用雲端硬碟建立權限。 |
|
刪除權限。 |
|
根據 ID 取得權限。 |
|
列出檔案或共用雲端硬碟的權限。 |
|
使用 patch 語意更新權限 |