REST Resource: permissions

资源：权限

文件的权限。权限向用户、群组、网域或所有人授予对文件或文件夹层次结构的访问权限。

某些资源方法（例如 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

string

此权限所代表的用户的 ID，与“关于”和“文件”资源中的 permissionId 相同。发出 drive.permissions.insert 请求时，必须指定 id 或 value 字段中的一个，除非权限类型为 anyone，在这种情况下，id 和 value 都会被忽略。
name

string

仅限输出。此权限的名称。
type

string

账号类型。允许的值有：

  • user
  • group
  • domain
  • anyone
role

string

此用户的主要角色。虽然将来可能会支持新值，但目前允许使用以下值：

  • owner
  • organizer
  • fileOrganizer
  • writer
  • reader
additionalRoles[]

string

此用户的其他角色。目前仅允许使用 commenter，但将来可能会支持更多语言。
authKey
(deprecated)

string

仅限输出。已弃用。
value

string

实体的电子邮件地址或域名。此字段在插入期间使用，不会填充到响应中。发出 drive.permissions.insert 请求时，必须指定 id 或 value 字段中的一个，除非权限类型为 anyone，在这种情况下，id 和 value 都会被忽略。
kind

string

仅限输出。始终为 drive#permission。
emailAddress

string

仅限输出。此权限所指的用户或群组的电子邮件地址。此字段仅限输出，在权限类型为 user 或 group 时显示。
domain

string

仅限输出。此权限所指实体的域名。此字段仅限输出，在权限类型为 user、group 或 domain 时显示。
etag

string

仅限输出。权限的 ETag。
permissionDetails[]

object

仅限输出。详细说明此共享云端硬盘内容的权限是继承而来，还是直接针对此内容。此字段仅限输出，仅适用于共享云端硬盘内容。
permissionDetails[].permissionType

string

仅限输出。此用户的权限类型。虽然将来可能会添加新值，但目前可以采用以下方法：

  • file
  • member
permissionDetails[].role

string

仅限输出。此用户的主要角色。虽然将来可能会添加新值，但目前可以采用以下值：

  • organizer
  • fileOrganizer
  • writer
  • reader
permissionDetails[].additionalRoles[]

string

仅限输出。此用户的其他角色。目前仅支持 commenter，但将来可能会支持更多。
permissionDetails[].inheritedFrom

string

仅限输出。继承自其权限的项目的 ID。此字段仅限输出。
permissionDetails[].inherited

boolean

仅限输出。此权限是否可继承。此字段始终填充。此字段仅限输出。
expirationDate

string

此权限的过期时间（RFC 3339 日期时间）。失效日期具有以下限制：

  • 只能针对用户和群组权限进行设置
  • 日期必须是将来的日期
  • 该日期不能是未来一年内的日期
teamDrivePermissionDetails[]
(deprecated)

object

仅限输出。已弃用：请改用 permissionDetails。
teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

仅限输出。已弃用：请改用 permissionDetails/permissionType。
teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

仅限输出。已弃用：请改用 permissionDetails/role。
teamDrivePermissionDetails[]
(deprecated).additionalRoles[]
(deprecated)

string

仅限输出。已弃用：请改用 permissionDetails/additionalRoles。
teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

仅限输出。已弃用：请改用 permissionDetails/inheritedFrom。
teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

仅限输出。已弃用：请改用 permissionDetails/inherited。
deleted

boolean

仅限输出。与此权限关联的账号是否已被删除。此字段仅适用于用户和群组权限。
view

string

指示此权限的视图。仅针对属于视图的权限填充。published 是唯一支持的值。
pendingOwner

boolean

与此权限关联的账号是否为受让所有者。系统只会为不在共享云端硬盘中的文件填充 user 类权限。

方法

delete

 从文件或共享云端硬盘中删除权限。

get

 根据 ID 获取权限。

getIdForEmail

 返回电子邮件地址的权限 ID。

insert

 插入文件或共享云端硬盘的权限。

list

 列出文件或共享云端硬盘的权限。

patch

 使用补丁语义更新权限。

update

 更新权限。