사용자의 공유 드라이브를 나열합니다.
이 메서드는 하나 이상의 검색어를 결합한 검색어인 q
매개변수를 허용합니다. 자세한 내용은 공유 드라이브 검색하기 가이드를 참고하세요.
HTTP 요청
GET https://www.googleapis.com/drive/v3/drives
URL은 gRPC 트랜스코딩 구문을 사용합니다.
쿼리 매개변수
매개변수 | |
---|---|
pageSize |
페이지당 반환할 최대 공유 드라이브 수입니다. |
pageToken |
공유 드라이브의 페이지 토큰입니다. |
q |
공유 드라이브 검색을 위한 쿼리 문자열입니다. |
useDomainAdminAccess |
도메인 관리자로 요청을 보냅니다. true로 설정하면 요청자가 관리자인 도메인의 모든 공유 드라이브가 반환됩니다. |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
공유 드라이브 목록.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"nextPageToken": string,
"kind": string,
"drives": [
{
object ( |
필드 | |
---|---|
nextPageToken |
공유 드라이브의 다음 페이지를 나타내는 페이지 토큰입니다. 목록의 끝에 도달하면 표시되지 않습니다. 어떤 이유로든 토큰이 거부되면 폐기해야 하며, 결과의 첫 페이지에서 페이지로 나누기를 다시 시작해야 합니다. 페이지 토큰은 일반적으로 몇 시간 동안 유효합니다. 하지만 새 항목이 추가되거나 삭제되면 예상 결과가 달라질 수 있습니다. |
kind |
리소스의 종류를 식별합니다. 값은 고정 문자열 |
drives[] |
공유 드라이브 목록 nextPageToken이 채워지면 이 목록이 불완전할 수 있으므로 추가 결과 페이지를 가져와야 합니다. |
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.readonly
일부 범위는 제한되며 앱에서 사용하려면 보안 평가가 필요합니다. 자세한 내용은 승인 가이드를 참조하세요.