사용자의 파일을 나열합니다.
이 메서드는 하나 이상의 검색어를 결합한 검색어인 q
매개변수를 허용합니다. 자세한 내용은 파일 검색 및 폴더 가이드를 참조하세요.
HTTP 요청
GET https://www.googleapis.com/drive/v2/files
URL은 gRPC 트랜스코딩 구문을 사용합니다.
쿼리 매개변수
매개변수 | |
---|---|
corpora |
쿼리가 적용되는 항목 (파일/문서) 본문입니다. 지원되는 본문은 |
corpus |
지원 중단됨: 쿼리가 적용되는 항목 (파일/문서)의 본문입니다. 대신 |
driveId |
검색할 공유 드라이브의 ID입니다. |
includeItemsFromAllDrives |
결과에 내 드라이브 및 공유 드라이브 항목을 모두 포함할지 여부입니다. |
includeTeamDriveItems |
지원 중단됨: 대신 |
maxResults |
페이지당 반환할 최대 파일 수입니다. 파일 목록의 끝에 도달하기 전이라도 결과 페이지가 일부만 표시되거나 비어 있을 수 있습니다. |
orderBy |
쉼표로 구분된 정렬 키 목록입니다. 유효한 키는 |
pageToken |
파일의 페이지 토큰입니다. |
projection |
지원 중단됨: 이 매개변수에는 함수가 없습니다. |
q |
파일 검색을 위한 쿼리 문자열입니다. |
spaces |
쿼리할 공백의 쉼표로 구분된 목록입니다. 지원되는 값은 |
supportsAllDrives |
요청하는 애플리케이션이 내 드라이브 및 공유 드라이브를 모두 지원하는지 여부 |
supportsTeamDrives |
지원 중단됨: 대신 |
teamDriveId |
지원 중단됨: 대신 |
includePermissionsForView |
응답에 포함할 추가 뷰의 권한을 지정합니다. |
includeLabels |
응답의 |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
파일 목록입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"nextPageToken": string,
"kind": string,
"etag": string,
"selfLink": string,
"incompleteSearch": boolean,
"nextLink": string,
"items": [
{
object ( |
필드 | |
---|---|
nextPageToken |
파일의 다음 페이지에 대한 페이지 토큰입니다. 파일 목록의 끝에 도달하면 표시되지 않습니다. 어떤 이유로든 토큰이 거부되면 폐기해야 하며, 결과의 첫 페이지에서 페이지로 나누기를 다시 시작해야 합니다. |
kind |
항상 |
etag |
목록의 ETag입니다. |
selfLink |
이 목록으로 돌아가는 링크입니다. |
incompleteSearch |
검색 프로세스가 완료되지 않았는지 여부입니다. true인 경우 모든 문서가 검색되지 않았으므로 일부 검색 결과가 누락될 수 있습니다. 이는 'allDrives'를 사용하여 여러 드라이브를 검색할 때 발생할 수 있습니다. 전체 코퍼스를 검색할 수 없습니다. 이 경우 클라이언트는 '기본값'과 같은 다른 코퍼스를 선택하여 쿼리 범위를 좁히는 것이 좋습니다. 또는 '드라이브'입니다. |
nextLink |
파일의 다음 페이지로 연결되는 링크입니다. |
items[] |
파일 목록입니다. 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.apps.readonly
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
일부 범위는 제한되며 앱에서 사용하려면 보안 평가가 필요합니다. 자세한 내용은 승인 가이드를 참조하세요.
코퍼스
열거형 | |
---|---|
DEFAULT |
사용자가 액세스한 항목입니다. |
DOMAIN |
사용자의 도메인에 공유된 항목입니다. |