Method: children.list

폴더의 하위 요소를 나열합니다.

HTTP 요청

GET https://www.googleapis.com/drive/v2/files/{folderId}/children

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
folderId

string

폴더의 ID입니다.

쿼리 매개변수

매개변수
maxResults

integer

반환할 최대 하위 요소 수입니다.

orderBy

string

쉼표로 구분된 정렬 키 목록입니다. 유효한 키는 createdDate, folder, lastViewedByMeDate, modifiedByMeDate, modifiedDate, quotaBytesUsed, recency, sharedWithMeDate, starred, title입니다. 각 키는 기본적으로 오름차순으로 정렬되지만 desc 수정자를 사용하면 순서를 바꿀 수 있습니다. 사용 예: ?orderBy=folder,modifiedDate desc,title 현재 약 100만 개의 파일이 있는 사용자의 경우 요청된 정렬 순서가 무시되는 제한사항이 있습니다.

pageToken

string

자녀의 페이지 토큰입니다.

q

string

자녀를 검색하기 위한 쿼리 문자열입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

파일의 하위 요소 목록입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현
{
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "selfLink": string,
  "nextLink": string,
  "items": [
    {
      object (ChildReference)
    }
  ]
}
필드
nextPageToken

string

하위 요소의 다음 페이지에 대한 페이지 토큰입니다. 하위 요소 목록의 끝에 도달하면 이 속성이 없습니다. 어떤 이유로든 토큰이 거부되면 토큰을 삭제하고 결과의 첫 번째 페이지에서 페이지로 나누기를 다시 시작해야 합니다.

kind

string

항상 drive#childList입니다.

etag

string

목록의 ETag입니다.

items[]

object (ChildReference)

하위 요소 목록입니다. nextPageToken이 채워지면 이 목록이 불완전할 수 있으며 결과 페이지를 추가로 가져와야 합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

일부 범위는 제한되어 있으며 앱에서 이를 사용하려면 보안 평가가 필요합니다. 자세한 내용은 승인 가이드를 참고하세요.