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

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