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,modifyDate 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.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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