GET/groups/{groupId}/folder/files/{fileId}/children

조직/그룹 폴더의 파일 목록을 조회한다.

Authorization

oauth2

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

Scope

file
file.read
group.folder
group.folder.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/groups/{groupId}/folder/files/{fileId}/children

Path Parameters

ParameterTypeDescription
groupId string 

조직/그룹 ID


required
example : group127-8545-4463-603b-04d550d23bf 
fileId string 

파일 ID


required
example : NzExNTMwMDF8MTQ2NzA1NjAxMDAwMHxGfDA 

Query Parameters

ParameterTypeDescription
orderBy string 

정렬 방법. 정렬 항목과 순서를 공백(%20)으로 구분하여 입력한다. 예) createdTime%20desc

  • 정렬 항목
    • 파일: createdTime, modifiedTime, accessedTime, fileExtension, fileName, filePath, fileSize, fileType, protect
    • 휴지통 파일: deletedTime, fileSize, fileType, fileName, originalPath
  • 순서
    • 오름차순: asc
    • 내림차순: desc

example : createdTime%20desc 
count integer 

조회 개수


default : 20
minimum : 1
maximum : 200
example : 20
format : int32 
cursor string 

커서값


example : JlIBsfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA==
allowReserved : false 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

OK

PropertyTypeDescription
files array (File) 

파일 정보

 
responseMetaData object (responseMetaData) 

응답 메타데이터

 

File

PropertyTypeDescription
accessedTime string 

접근 날짜


readOnly : true 
createdTime string 

생성 날짜


readOnly : true 
modifiedTime string 

수정 날짜


readOnly : true 
fileId string 

파일 ID


readOnly : true 
parentFileId string 

부모 폴더의 fileId


readOnly : true 
fileName string 

파일 이름


readOnly : true 
fileSize integer 

파일 크기


format : int64
readOnly : true 
filePath string 

파일 경로


readOnly : true 
fileType string 

파일 유형

  • AUDIO: 오디오 파일
  • DOC: 문서 파일
  • ETC: 기타 파일
  • EXE: 실행 파일
  • FOLDER: 폴더
  • IMAGE: 사진 파일
  • VIDEO: 영상 파일
  • ZIP: 압축 파일

Allowed values : AUDIO, DOC, ETC, EXE, FOLDER, IMAGE, VIDEO, ZIP 
hasPermission boolean 

특정 구성원에게 권한이 부여되었는지 여부
이 속성은 공유 드라이브, 조직/그룹 폴더에서만 사용된다.


readOnly : true
nullable : false 
permissionRootFileId string 

폴더 접근 권한이 설정된 폴더의 파일 ID.
해당 폴더 또는 상위 폴더의 파일 ID가 될 수 있다.
폴더 접근 권한 관련 API를 호출하는 데 사용된다.
이 속성은 공유 드라이브, 조직/그룹 폴더에서만 사용된다.


readOnly : true
nullable : true 
shared boolean 

해당 폴더 혹은 상위 폴더가 현재 공유 중인지 여부
이 속성은 내 드라이브, 초대받은 폴더에서만 사용된다.


readOnly : true
nullable : false 
shareRootFileId string 

해당 폴더 혹은 상위 폴더가 공유 중인 경우, 공유된 루트 폴더의 파일 ID.
이 속성은 내 드라이브, 초대받은 폴더에서만 사용된다.


readOnly : true
nullable : true 
resourceLocation integer 

리소스 위치 코드


format : int32
readOnly : true 
statuses array (FileStatus) 

파일 상태

 

FileStatus

PropertyTypeDescription
FileStatus string 

파일 상태

  • LOCKED: 잠긴 파일
  • MALWARE: 악성 파일
  • PROTECTED: 중요 표시된 파일
  • IN_PROGRESS: 업로드 중인 파일

Allowed values : LOCKED, MALWARE, PROTECTED, IN_PROGRESS 

responseMetaData

PropertyTypeDescription
nextCursor string 

다음 목록 조회 시 사용하는 커서값


readOnly : true 

Response Example

example

1{2  "files": [3    {4      "fileId": "QDIxMDAwMDAwMDAwMTcwfDExODE1MDg3MzQ0NzJ8RHww",5      "parentFileId": "QDIxMDAwMDAwMDAwMTcwfDExNzgyODY2MjgxMDR8RHww",6      "resourceLocation": 24101,7      "fileSize": 10,8      "fileName": "works.txt",9      "filePath": "/GroupName/works.txt",10      "fileType": "DOC",11      "createdTime": "2020-11-13T18:20:05.05+09:00",12      "modifiedTime": "2021-04-05T21:14:05.05+09:00",13      "accessedTime": "2021-04-05T21:14:05.05+09:00",14      "statuses": [],15      "hasPermission": true,16      "permissionRootFileId": "QDIxMDAwMDAwMDAwMTcwfDExNzgyODY2MjgxMDR8RHww",17      "shared": false,18      "shareRootFileId": null19    },20    {21      "fileId": "NzExNTMwMDF8MTQ2NzA1NjAxMDAwMHxGfDA",22      "parentFileId": "QDIxMDAwMDAwMDAwMTcwfDExNzgyODY2MjgxMDR8RHww",23      "resourceLocation": 24101,24      "fileSize": 0,25      "fileName": "worksFolder",26      "filePath": "/GroupName/worksFolder/",27      "fileType": "FOLDER",28      "createdTime": "2020-11-13T18:20:05.05+09:00",29      "modifiedTime": "2021-04-05T21:14:05.05+09:00",30      "accessedTime": "2021-04-05T21:14:05.05+09:00",31      "statuses": [],32      "hasPermission": true,33      "permissionRootFileId": "QDIxMDAwMDAwMDAwMTcwfDExNzgyODY2MjgxMDR8RHww",34      "shared": false,35      "shareRootFileId": null36    }37  ],38  "responseMetaData": {39    "nextCursor": "JlIBsfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA=="40  }41}