POST/sharedrives/{sharedriveId}/permissions

공용 드라이브(공용 폴더)의 구성원 권한을 생성한다. 그룹사 내의 특정 사용자/조직/그룹에게 권한을 부여할 수 있다.
공용 드라이브의 접근 범위(accessibleRange)가 MEMBER로 변경된다.
그룹사 또는 회사 전체로 접근 범위를 변경하려면 드라이브 수정 API를 사용해야 한다.

Authorization

oauth2

OAuth 2.0 인증.
자세한 인증 방식은 인가·인증을 참고한다.

Scope

file

HTTP Request

POSThttps://www.worksapis.com/v1.0/sharedrives/{sharedriveId}/permissions

Path Parameters

ParameterTypeDescription
sharedriveId string 

공용 드라이브 ID


required
example : @2101000000000008 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Request Body

권한을 추가할 사용자의 ID, 유형 및 타입을 받을 때 사용한다.

PropertyTypeDescription
userId string 

사용자 ID

  • 메일
  • 리소스 ID
  • 외부 키 "externalKey:{externalKey}" 형태
    조직 ID
    그룹 ID

required
minLength : 1 
userType string 

사용자 유형

  • USER: 사용자
  • ORGUNIT: 조직
  • GROUP: 그룹

required
Allowed values : USER, ORGUNIT, GROUP 
type string 

편집 권한

  • READ: 읽기 권한
  • WRITE: 쓰기 권한

default : WRITE
Allowed values : READ, WRITE 

Request Example

example

1{2  "userId": "works@example.com",3  "userType": "USER",4  "type": "READ"5}

Response

HTTP 201

OK

PropertyTypeDescription
permissionId string 

권한 ID


required
minLength : 1
readOnly : true 
type string 

편집 권한

  • READ: 읽기 권한
  • WRITE: 쓰기 권한

required
Allowed values : READ, WRITE 
userId string 

사용자 ID


required
minLength : 1
readOnly : true 
userType string 

사용자 유형

  • USER: 사용자
  • ORGUNIT: 조직
  • GROUP: 그룹

required
Allowed values : USER, ORGUNIT, GROUP 
userName string 

사용자 이름


required
minLength : 1
readOnly : true 

Response Example

example

1{2  "permissionId": "QDIxMDAwMDAwMDAwMTcwfEdST1VQfDEwMTAwMDAwMDExNDY1MA",3  "type": "WRITE",4  "userId": "group127-8545-4463-603b-04d550d23bf",5  "userType": "GROUP",6  "userName": "test name"7}

HTTP 403

Forbidden