Method: drives.list

사용자의 공유 드라이브를 나열합니다.

이 메서드는 하나 이상의 검색어를 결합한 검색어인 q 매개변수를 허용합니다. 자세한 내용은 공유 드라이브 검색 가이드를 참고하세요.

HTTP 요청

GET https://www.googleapis.com/drive/v3/drives

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

쿼리 매개변수

매개변수
pageSize

integer

페이지당 반환할 최대 공유 드라이브 수입니다.
pageToken

string

공유 드라이브의 페이지 토큰입니다.
q

string

공유 드라이브 검색을 위한 쿼리 문자열입니다.
useDomainAdminAccess

boolean

도메인 관리자로서 요청을 보냅니다. true로 설정하면 요청자가 관리자인 도메인의 모든 공유 드라이브가 반환됩니다. false (기본값)로 설정하면 더 많은 항목이 있더라도 최대 1,000개가 반환됩니다.

요청 본문

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

응답 본문

공유 드라이브 목록.

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

JSON 표현 
{
  "nextPageToken": string,
  "kind": string,
  "drives": [
    {
      object (Drive)
    }
  ]
}
필드
nextPageToken

string

공유 드라이브의 다음 페이지에 대한 페이지 토큰입니다. 목록의 끝에 도달한 경우에는 이 속성이 없습니다. 어떤 이유로든 토큰이 거부되면 폐기해야 하며, 결과의 첫 페이지에서 페이지로 나누기를 다시 시작해야 합니다. 페이지 토큰은 일반적으로 몇 시간 동안 유효합니다. 하지만 새 항목이 추가되거나 삭제되면 예상 결과가 달라질 수 있습니다.
kind

string

리소스 종류를 식별합니다. 값: 고정 문자열 "drive#driveList".
drives[]

object (Drive)

공유 드라이브 목록 nextPageToken이 채워지면 이 목록이 불완전할 수 있으며 결과 페이지를 추가로 가져와야 합니다.

승인 범위

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

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.readonly

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