사용자의 파일을 나열합니다.
이 메서드는 하나 이상의 검색어를 결합한 검색어인 q
매개변수를 허용합니다. 자세한 내용은 파일 검색 및 폴더 가이드를 참조하세요.
HTTP 요청
GET https://www.googleapis.com/drive/v3/files
URL은 gRPC 트랜스코딩 구문을 사용합니다.
쿼리 매개변수
매개변수 | |
---|---|
corpora |
쿼리가 적용되는 항목 (파일/문서) 본문입니다. 지원되는 본문은 'user', 'domain', 'drive', 'allDrives'입니다. '사용자' 선호 또는 '운전' 'allDrives'로 효율적으로 사용할 수 있습니다 기본적으로 코퍼스는 '사용자'로 설정됩니다. 하지만 이는 'q'를 통해 설정된 필터에 따라 달라질 수 있습니다. 매개변수 값으로 사용됩니다. |
corpus |
지원 중단됨: 나열할 파일의 소스입니다. 'corpora' 사용 하세요. |
driveId |
검색할 공유 드라이브의 ID입니다. |
includeItemsFromAllDrives |
결과에 내 드라이브 및 공유 드라이브 항목을 모두 포함할지 여부입니다. |
includeTeamDriveItems |
지원 중단됨: 대신 |
orderBy |
쉼표로 구분된 정렬 키 목록입니다. 유효한 키는 'createdTime', 'folder', 'generatedByMeTime', 'modifyTime', 'name', 'name_natural', 'quotaBytesUsed', 'recency', 'sharedWithMeTime', 'starred', 'viewedByMeTime'입니다. 각 키는 기본적으로 오름차순으로 정렬되지만 'desc'를 사용하여 되돌릴 수 있습니다. 특수키를 사용합니다. 사용 예: ?orderBy=folder,수정된시간 desc,name. |
pageSize |
페이지당 반환할 최대 파일 수입니다. 파일 목록의 끝에 도달하기 전이라도 결과 페이지가 일부만 표시되거나 비어 있을 수 있습니다. |
pageToken |
다음 페이지에서 이전 목록 요청을 계속하기 위한 토큰입니다. 'nextPageToken' 값으로 설정해야 합니다. 가져올 수 있습니다. |
q |
파일 결과를 필터링하기 위한 쿼리입니다. '파일 검색 및 폴더' 지원되는 문법 가이드를 참조하세요. |
spaces |
코퍼스 내에서 쿼리할 스페이스의 쉼표로 구분된 목록입니다. 지원되는 값은 'drive'입니다. 'appDataFolder'를 추가합니다 |
supportsAllDrives |
요청하는 애플리케이션이 내 드라이브 및 공유 드라이브를 모두 지원하는지 여부 |
supportsTeamDrives |
지원 중단됨: 대신 |
teamDriveId |
지원 중단됨: 대신 |
includePermissionsForView |
응답에 포함할 추가 뷰의 권한을 지정합니다. '게시됨'만 만 지원됩니다. |
includeLabels |
응답의 |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
파일 목록입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"nextPageToken": string,
"kind": string,
"incompleteSearch": boolean,
"files": [
{
object ( |
필드 | |
---|---|
nextPageToken |
파일의 다음 페이지에 대한 페이지 토큰입니다. 파일 목록의 끝에 도달하면 표시되지 않습니다. 어떤 이유로든 토큰이 거부되면 폐기해야 하며, 결과의 첫 페이지에서 페이지로 나누기를 다시 시작해야 합니다. 페이지 토큰은 일반적으로 몇 시간 동안 유효합니다. 하지만 새 항목이 추가되거나 삭제되면 예상 결과가 달라질 수 있습니다. |
kind |
리소스의 종류를 식별합니다. 값은 고정 문자열 |
incompleteSearch |
검색 프로세스가 완료되지 않았는지 여부입니다. true인 경우 모든 문서가 검색되지 않았기 때문에 일부 검색 결과가 누락될 수 있습니다. 이는 'allDrives'로 여러 드라이브를 검색할 때 발생할 수 있습니다. 모든 코퍼스를 검색할 수 없습니다. 이 경우 클라이언트는 '사용자'와 같은 다른 코퍼스를 선택하여 쿼리의 범위를 좁히는 것이 좋습니다. '운전' 같은 이름을 지정할 수 있습니다. |
files[] |
파일 목록입니다. nextPageToken이 채워지면 이 목록이 불완전할 수 있으므로 추가 결과 페이지를 가져와야 합니다. |
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
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
일부 범위는 제한되며 앱에서 사용하려면 보안 평가가 필요합니다. 자세한 내용은 승인 가이드를 참조하세요.
코퍼스
열거형 | |
---|---|
user |
사용자가 소유하거나 공유된 파일입니다. |
domain |
사용자의 도메인에 공유된 파일 |