REST Resource: permissions

리소스: 권한

파일에 대한 권한입니다. 권한은 사용자, 그룹, 도메인 또는 전 세계에 파일 또는 폴더 계층 구조에 대한 액세스 권한을 부여합니다. 자세한 내용은 파일, 폴더, 드라이브 공유하기를 참고하세요.

기본적으로 권한 요청은 필드의 하위 집합만 반환합니다. 권한 kind, ID, type, role은 항상 반환됩니다. 특정 필드를 가져오려면 특정 필드 반환을 참고하세요.

일부 리소스 메서드 (예: 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,
  "inheritedPermissionsDisabled": boolean
}
필드
id

string

출력 전용입니다. 이 권한의 ID로 수혜자의 고유 식별자이며 사용자 리소스에 permissionId로 게시됩니다. ID는 불투명한 값으로 취급되어야 합니다.
displayName

string

출력 전용입니다. 권한 값의 '적절한' 이름입니다. 다음은 각 권한 유형의 예시 목록입니다.

  • user - Google 계정에 정의된 사용자의 전체 이름(예: '김민경')
  • group: Google 그룹 이름(예: '회사 관리자')
  • domain - 문자열 도메인 이름(예: 'cymbalgroup.com')
  • anyone: displayName이 없습니다.
type

string

수혜자의 유형입니다. 지원되는 값은 다음과 같습니다.

  • user
  • group
  • domain
  • anyone

권한을 만들 때 type이 user 또는 group이면 사용자 또는 그룹의 emailAddress를 제공해야 합니다. type이 domain이면 domain을 제공해야 합니다. type이 anyone이면 추가 정보가 필요하지 않습니다.
kind

string

출력 전용입니다. 리소스 종류를 식별합니다. 값: 고정 문자열 "drive#permission".
permissionDetails[]

object

출력 전용입니다. 이 항목의 권한이 상속되는지 아니면 이 항목에 직접 적용되는지 여부의 세부정보입니다.
permissionDetails[].permissionType

string

출력 전용입니다. 이 사용자의 권한 유형입니다. 지원되는 값은 다음과 같습니다.

  • file
  • member
permissionDetails[].inheritedFrom

string

출력 전용입니다. 이 권한이 상속된 항목의 ID입니다. 공유 드라이브의 항목에 대해서만 채워집니다.
permissionDetails[].role

string

출력 전용입니다. 이 사용자의 기본 역할입니다. 지원되는 값은 다음과 같습니다.

  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader

자세한 내용은 역할 및 권한을 참조하세요.
permissionDetails[].inherited

boolean

출력 전용입니다. 이 권한이 상속되는지 여부입니다. 이 필드는 항상 채워집니다. 출력 전용 필드입니다.
emailAddress

string

출력 전용입니다. 이 권한이 참조하는 사용자 또는 그룹의 이메일 주소입니다.
role

string

이 권한이 부여하는 역할입니다. 지원되는 값은 다음과 같습니다.

  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader

자세한 내용은 역할 및 권한을 참조하세요.
allowFileDiscovery

boolean

권한에서 검색을 통해 파일을 검색할 수 있도록 허용할지 여부입니다. domain 또는 anyone 유형의 권한에만 적용될 수 있습니다.
domain

string

출력 전용입니다. 이 권한이 참조하는 도메인입니다.
expirationTime

string

이 권한이 만료되는 시간입니다 (RFC 3339 날짜/시간). 만료 시간에는 다음과 같은 제한사항이 있습니다.

  • 사용자 및 그룹 권한에만 설정할 수 있습니다.
  • 시간은 미래여야 합니다.
  • 시간은 현재로부터 1년을 초과할 수 없습니다.
teamDrivePermissionDetails[]
(deprecated)

object

출력 전용입니다. 지원 중단됨: 출력 전용입니다. 대신 permissionDetails를 사용하세요.
teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

지원 중단됨: 출력 전용입니다. 대신 permissionDetails/permissionType을 사용하세요.
teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

지원 중단됨: 출력 전용입니다. 대신 permissionDetails/inheritedFrom을 사용하세요.
teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

지원 중단됨: 출력 전용입니다. 대신 permissionDetails/role을 사용하세요.
teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

지원 중단됨: 출력 전용입니다. 대신 permissionDetails/inherited를 사용하세요.
deleted

boolean

출력 전용입니다. 이 권한과 연결된 계정이 삭제되었는지 여부입니다. 이 필드는 user 또는 group 유형의 권한에만 적용됩니다.
view

string

이 권한의 뷰를 나타냅니다. 뷰에 속한 권한에 대해서만 채워집니다.

지원되는 값은 published 및 metadata뿐입니다.

  • published: 권한의 역할은 publishedReader입니다.
  • metadata: 항목에 제한된 액세스 권한이 있고 범위에 상위 항목에 대한 읽기 액세스 권한이 있으므로 항목은 metadata 뷰에만 표시됩니다. metadata 뷰는 폴더에서만 지원됩니다.

자세한 내용은 뷰를 참조하세요.
pendingOwner

boolean

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

boolean

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

메서드

create

 파일 또는 공유 드라이브에 대한 권한을 만듭니다.

delete

 권한을 삭제합니다.

get

 ID로 권한을 가져옵니다.

list

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

update

 패치 시맨틱스로 권한을 업데이트합니다.