GET/sharedrives/{sharedriveId}

공용 드라이브(공용 폴더)를 조회한다.

참고 공용 공간의 차이는 공용 공간의 폴더 유형(공용 폴더, 메시지방 폴더, 초대받은 폴더)별 특징을 참고한다.

Authorization

oauth2

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

Scope

file
file.read

HTTP Request

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

Path Parameters

ParameterTypeDescription
sharedriveId string 

공용 드라이브 ID


required
example : @2101000000000008 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

OK

PropertyTypeDescription
accessDenies array (ShareDriveAccessDeny) 

접근 제한

 
createdTime string 

생성 날짜


readOnly : true 
description string 

설명

 
hasPermission boolean 

특정 멤버에게 권한이 부여되었는지 여부


readOnly : true 
accessibleRange string 

접근 범위

  • TENANT: 그룹사 전체 구성원 접근 가능
  • DOMAIN: 회사 전체 구성원 접근 가능
  • MEMBER: 그룹사 내 지정된 구성원만 접근 가능

참고 값이 MEMBER이면 hasPermission: true로 설정된다.


Allowed values : TENANT, DOMAIN, MEMBER
nullable : false 
masters array (ShareDriveMaster) 

마스터

 
name string 

이름

 
quota object (quota) 

용량 정보


readOnly : true 
sharedriveId string 

공용 드라이브 ID


readOnly : true 
permissionType string 

편집 권한

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

Allowed values : READ, WRITE 

ShareDriveAccessDeny

PropertyTypeDescription
id string 

접근 제한 ID
type: user-type이면 userTypeId를 입력해야 한다.

 
name string 

접근 제한 이름


readOnly : true 
type string 

접근 제한 종류


Allowed values : user-type 

ShareDriveMaster

PropertyTypeDescription
id string 

마스터 사용자 ID

 
name string 

마스터 사용자 이름


readOnly : true 

quota

PropertyTypeDescription
trash integer 

휴지통 용량


format : int64
readOnly : true 
used integer 

사용 용량


format : int64
readOnly : true 

Response Example

example

1{2  "sharedriveId": "@2101000000000008",3  "name": "share drive",4  "description": "description here",5  "createdTime": "2020-12-16T19:40:15.15+09:00",6  "quota": {7    "used": 46426,8    "trash": 09  },10  "hasPermission": false,11  "masters": [12    {13      "id": "userf7da-f82c-4284-13e7-030f3b4c756x",14      "name": "User Name"15    }16  ],17  "accessDenies": [18    {19      "type": "user-type",20      "id": "041b68d3-263a-4fbe-9bc5-0350c49d1c42",21      "name": "아르바이트"22    }23  ],24  "permissionType": "READ",25  "accessibleRange": "DOMAIN"26}