資源:權限
檔案的權限。這項權限可讓使用者、群組、網域或全世界存取檔案或資料夾階層。
部分資源方法 (例如 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 語意更新權限。 |