資源:權限
檔案的權限。這項權限可讓使用者、群組、網域或全世界存取檔案或資料夾階層。
部分資源方法 (例如 permissions.update
) 需要 permissionId
。使用 permissions.list
方法擷取檔案、資料夾或共用雲端硬碟的 ID。
JSON 表示法 |
---|
{ "id": string, "name": string, "type": string, "role": string, "additionalRoles": [ string ], "authKey": string, "value": string, "kind": string, "withLink": boolean, "photoLink": string, "selfLink": string, "emailAddress": string, "domain": string, "etag": string, "permissionDetails": [ { "permissionType": string, "role": string, "additionalRoles": [ string ], "inheritedFrom": string, "inherited": boolean } ], "expirationDate": string, "teamDrivePermissionDetails": [ { "teamDrivePermissionType": string, "role": string, "additionalRoles": [ string ], "inheritedFrom": string, "inherited": boolean } ], "deleted": boolean, "view": string, "pendingOwner": boolean } |
欄位 | |
---|---|
id |
這項權限的使用者 ID,且與「關於」和「檔案」資源中的 |
name |
僅供輸出。這項權限的名稱。 |
type |
帳戶類型。允許的值包括:
|
role |
這位使用者的主要角色。雖然未來可能會支援新的值,但目前允許下列值:
|
additionalRoles[] |
這位使用者的其他角色。目前只能使用 |
authKey |
僅供輸出。已淘汰。 |
value |
實體的電子郵件地址或網域名稱。這會在插入作業期間使用,且不會填入回應。提出 |
kind |
僅供輸出。一律為 |
withLink |
這項權限是否需要連結。 |
photoLink |
僅供輸出。個人資料相片連結 (如果有的話)。 |
selfLink |
僅供輸出。返回這項權限的連結。 |
emailAddress |
僅供輸出。這個權限所參照的使用者或群組電子郵件地址。這是僅限輸出的欄位,當權限類型為 |
domain |
僅供輸出。這項權限參照的實體網域名稱。這是僅限輸出的欄位,當權限類型為 |
etag |
僅供輸出。權限的 ETag。 |
permissionDetails[] |
僅供輸出。詳細列出這個共用雲端硬碟項目的權限是沿用還是直接沿用而來。這個欄位只有輸出欄位,僅適用於共用雲端硬碟項目。 |
permissionDetails[].permissionType |
僅供輸出。這個使用者的權限類型。雖然日後可能會加入新值,但目前可能如下:
|
permissionDetails[].role |
僅供輸出。這位使用者的主要角色。雖然我們日後可能會加入新值,但目前可能如下:
|
permissionDetails[].additionalRoles[] |
僅供輸出。這位使用者的其他角色。目前只能使用 |
permissionDetails[].inheritedFrom |
僅供輸出。沿用這項權限的項目 ID。此為僅供輸出的欄位。 |
permissionDetails[].inherited |
僅供輸出。這項權限是否已沿用。這個欄位一律會填入資料。此為僅供輸出的欄位。 |
expirationDate |
這項權限的到期時間 (RFC 3339 日期時間)。到期日有以下限制:
|
teamDrivePermissionDetails[] |
僅供輸出。已淘汰:請改用 |
teamDrivePermissionDetails[] |
僅供輸出。已淘汰:請改用 |
teamDrivePermissionDetails[] |
僅供輸出。已淘汰:請改用 |
teamDrivePermissionDetails[] |
僅供輸出。已淘汰:請改用 |
teamDrivePermissionDetails[] |
僅供輸出。已淘汰:請改用 |
teamDrivePermissionDetails[] |
僅供輸出。已淘汰:請改用 |
deleted |
僅供輸出。與這項權限相關聯的帳戶是否已刪除。這個欄位僅適用於使用者和群組權限。 |
view |
表示這項權限的檢視畫面。只有資料檢視擁有的權限才會填入。 |
pendingOwner |
與這項權限相關聯的帳戶是否為待審核的擁有者。系統只會針對不在共用雲端硬碟中的檔案填入 |
方法 |
|
---|---|
|
刪除檔案或共用雲端硬碟的權限。 |
|
依 ID 取得權限。 |
|
傳回電子郵件地址的權限 ID。 |
|
插入檔案或共用雲端硬碟的權限。 |
|
列出檔案或共用雲端硬碟的權限。 |
|
使用修補程式語意更新權限。 |
|
更新權限。 |