이 참조 가이드에서는 Google Drive API: 파일, 폴더, 공유 드라이브를 필터링합니다.
파일 검색 예는 파일 및 폴더 검색하기를 참고하세요.
공유 드라이브 검색 예시를 보려면 공유 드라이브 검색하기를 참고하세요.
쿼리 문자열 구문
쿼리 문자열은 다음 세 부분으로 구성됩니다.
query_term operator values
각 항목의 의미는 다음과 같습니다.
query_term은 검색할 검색어 또는 필드입니다.operator는 검색어의 조건을 지정합니다.values는 검색을 필터링하는 데 사용할 값입니다. 있습니다.
쿼리 연산자
다음 표는 유효한 쿼리 연산자를 보여줍니다.
| 연산자 | 사용 |
|---|---|
contains |
한 문자열의 콘텐츠가 다른 문자열에 있습니다. |
= |
문자열이나 불리언의 내용은 다른 값과 같습니다. |
!= |
문자열이나 불리언의 내용이 서로 같지 않습니다. |
< |
값이 다른 값보다 작습니다. |
<= |
값이 다른 값보다 작거나 같습니다. |
> |
값이 다른 값보다 큽니다. |
>= |
값이 다른 값보다 크거나 같습니다. |
in |
요소는 컬렉션 내에 포함됩니다. |
and |
두 쿼리 모두와 일치하는 항목을 반환합니다. |
or |
두 검색어 중 하나와 일치하는 항목을 반환합니다. |
not |
검색어를 무효화합니다. |
has |
컬렉션에는 매개변수와 일치하는 요소가 포함됩니다. |
파일별 검색어
다음 표에는 유효한 파일 검색어가 모두 나와 있습니다. 데이터 유형 및
자세한 설명은 files 리소스를
참조
| 검색어 | 유효한 연산자 | 사용 |
|---|---|---|
name |
contains, =, != |
파일 이름입니다. 작은따옴표로 묶습니다 ('). 'Valentine\'s Day'와 같이 \'를 사용하여 쿼리에서 작은따옴표를 이스케이프 처리합니다. |
fullText |
contains |
name, description, indexableText 속성, 파일 콘텐츠 또는 파일의 메타데이터에 있는 텍스트가 일치하는지 여부 작은따옴표로 묶습니다 ('). 'Valentine\'s Day'와 같이 \'를 사용하여 쿼리에서 작은따옴표를 이스케이프 처리합니다. |
mimeType |
contains, =, != |
파일의 MIME 유형입니다. 작은따옴표로 묶습니다 ('). 'Valentine\'s Day'와 같이 \'를 사용하여 쿼리에서 작은따옴표를 이스케이프 처리합니다. MIME 유형에 관한 자세한 내용은 Google Workspace 및 Google Drive에서 지원되는 MIME 유형을 참고하세요. |
modifiedTime |
<=, <, =, !=, >, >= |
마지막으로 파일을 수정한 날짜입니다. RFC 3339 형식. 기본 시간대는 UTC입니다(예: 2012-06-04T12:00:00-08:00). date 유형의 필드는 서로 비교할 수 없으며 상수 날짜만 비교할 수 있습니다. |
viewedByMeTime |
<=, <, =, !=, >, >= |
사용자가 파일을 마지막으로 본 날짜 RFC 3339 형식. 기본 시간대는 UTC입니다(예: 2012-06-04T12:00:00-08:00). date 유형의 필드는 서로 비교할 수 없으며 상수 날짜만 비교할 수 있습니다. |
trashed |
=, != |
파일이 휴지통에 있는지 여부 true 또는 false일 수 있습니다. |
starred |
=, != |
파일이 별표표시되었는지 여부 true 또는 false일 수 있습니다. |
parents |
in |
상위 컬렉션에 지정된 ID가 포함되는지 여부입니다. |
owners |
in |
파일을 소유한 사용자입니다. |
writers |
in |
파일을 수정할 권한이 있는 사용자 또는 그룹 permissions 리소스 참조를 확인하세요. |
readers |
in |
파일을 읽을 권한이 있는 사용자 또는 그룹입니다. permissions 리소스 참조를 확인하세요. |
sharedWithMe |
=, != |
사용자의 '공유 문서함'에 있는 파일 컬렉션의 일부입니다. 모든 파일 사용자가 파일의 액세스 제어 목록 (ACL)에 있습니다. true 또는 false일 수 있습니다. |
createdTime |
<=, <, =, !=, >, >= |
공유 드라이브가 생성된 날짜입니다. RFC 3339 형식을 사용합니다. 기본 시간대는 UTC입니다(예: 2012-06-04T12:00:00-08:00). |
properties |
has |
공개 맞춤 파일 속성 |
appProperties |
has |
비공개 맞춤 파일 속성. |
visibility |
=, != |
파일의 공개 상태 수준입니다. 유효한 값은 anyoneCanFind, anyoneWithLink, domainCanFind, domainWithLink, limited입니다. 작은따옴표로 묶습니다 ('). |
shortcutDetails.targetId |
=, != |
바로가기가 가리키는 항목의 ID입니다. |
다음은 연산자와 검색어 조합을 보여줍니다.
contains연산자는name항. 예를 들어 이름이 (총HelloWorld개)name contains 'Hello'쿼리는 다음을 반환합니다. 결과,name contains 'World'쿼리는 그렇지 않습니다.contains연산자는fullText항입니다. 예를 들어 문서의 전체 텍스트에 문자열 'HelloWorld', 쿼리fullText contains 'HelloWorld'만 결과를 반환합니다.contains연산자는 다음 조건을 충족하는 경우 정확한 영숫자 구문과 일치합니다. 큰따옴표로 묶습니다 예를 들어 문서의fullText가 에 'Hello there world' 문자열이 포함되어 있으면fullText contains '"Hello there"'쿼리는 결과를 반환하지만fullText contains '"Hello world"'쿼리는 결과를 반환하지 않습니다. 또한 검색은 영숫자이므로 전체 'Hello_world' 문자열이 포함된 문서의 텍스트에fullText contains '"Hello world"'는 결과를 반환합니다.owners,writers,readers용어가permissions목록에서 권한에 대한role권한 역할 권한의 전체 목록은 다음을 참조하세요. 역할 및 권한.
쿼리 문자열 검색의 예를 더 보려면 파일 쿼리 문자열 예시를 참조하세요.
공유 드라이브 관련 검색어
다음 표에는 유효한 공유 드라이브 검색어가 모두 나와 있습니다. 데이터 유형 및
설명은 drives 리소스 참고
참조
| 검색어 | 유효한 연산자 | 사용 | useDomainAdminAccess 설정 |
|---|---|---|---|
createdTime |
<=, <, =, !=, >, >= |
공유 드라이브가 생성된 날짜입니다. RFC 3339 형식. 기본 시간대는 UTC입니다(예: 2012-06-04T12:00:00-08:00). |
true |
hidden |
=, != |
공유 드라이브를 숨길지 여부를 지정합니다. true 또는 false일 수 있습니다. |
false |
memberCount |
<=, <, =, !=, >, >= |
공유 드라이브의 멤버인 사용자 및 그룹 수입니다. 숫자 값을 사용합니다. | true |
name |
contains, =, != |
공유 드라이브의 이름입니다. 작은따옴표로 묶습니다 ('). 'Valentine\'s Day'와 같이 \'를 사용하여 쿼리에서 작은따옴표를 이스케이프 처리합니다. |
true |
organizerCount |
<=, <, =, !=, >, >= |
공유 드라이브 주최자인 사용자 및 그룹 수 숫자 값을 사용합니다. | true |
orgUnitId |
=, != |
공유 드라이브의 조직 단위 ID입니다. 문자열 값을 사용합니다. | true |
검색어 문자열 검색의 예를 더 보려면 공유 드라이브 쿼리 문자열을 참조하세요. 예시를 참조하세요.