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,
  "inheritedPermissionsDisabled": boolean
}
필드
id

string

이 권한이 참조하는 사용자의 ID이며 정보 및 파일 리소스의 permissionId와 동일합니다. drive.permissions.insert 요청을 할 때는 권한 유형이 anyone이 아닌 한 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 요청을 할 때는 권한 유형이 anyone이 아닌 한 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 날짜/시간). 만료일에는 다음과 같은 제한사항이 있습니다.

  • 사용자 및 그룹 권한에만 설정할 수 있습니다.
  • 미래 날짜여야 합니다.
  • 1년 이후의 날짜는 입력할 수 없습니다.
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

및

metadata

값만 지원됩니다.

  • published

    : 권한의 역할은 published_reader입니다.

  • metadata

    : 항목에 제한된 액세스 권한이 있고 범위가 상위 요소에 대한 읽기 전용 액세스 권한이 있으므로 항목이 메타데이터 뷰에만 표시됩니다. 참고:

    metadata

    뷰는 현재 폴더에서만 지원됩니다.

pendingOwner

boolean

이 권한과 연결된 계정이 대기 중인 소유자인지 여부입니다. 공유 드라이브에 없는 파일의 user 유형 권한에 대해서만 채워집니다.
inheritedPermissionsDisabled

boolean

이 속성이 true이면 항목에 직접 추가된 권한이 있는 주최자, 소유자, 사용자만 항목에 액세스할 수 있습니다.

메서드

delete

 파일 또는 공유 드라이브에서 권한을 삭제합니다.

get

 ID별로 권한을 가져옵니다.

getIdForEmail

 이메일 주소의 권한 ID를 반환합니다.

insert

 파일 또는 공유 드라이브의 권한을 삽입합니다.

list

 파일 또는 공유 드라이브의 권한을 표시합니다.

patch

 패치 시맨틱스를 사용하여 권한을 업데이트합니다.

update

 권한을 업데이트합니다.