검색어 및 연산자

이 참조 가이드에서는 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). Drive API v3에서만 지원됩니다.
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

검색어 검색의 더 많은 예시는 공유 드라이브 검색어 예시를 참고하세요.