공유 드라이브 검색

이 가이드에서는 Google Drive API가 공유 드라이브를 검색하는 여러 방법을 지원하는 방법을 설명합니다.

특정 공유 드라이브 세트를 검색하려면 쿼리 문자열 q 필드 list 메서드를 drives 리소스와 함께 사용하여 하나 이상의 검색어를 결합하여 반환할 드라이브를 필터링합니다.

쿼리 문자열에는 다음 세 가지 부분이 포함됩니다.

query_term operator values

각 항목의 의미는 다음과 같습니다.

  • query_term 은 검색할 쿼리 용어 또는 필드입니다.

  • operator 는 쿼리 용어의 조건을 지정합니다.

  • values 는 검색 결과를 필터링하는 데 사용할 특정 값입니다.

예를 들어 다음 쿼리 문자열은 검색을 필터링하여 이름이 'Google Drive API resources'인 공유 드라이브만 반환합니다.

q: name = 'Google Drive API resources' & useDomainAdminAccess=false

모든 공유 드라이브 쿼리 용어를 보려면 공유 드라이브별 쿼리 용어를 참고하세요.

쿼리를 구성하는 데 사용할 수 있는 모든 쿼리 연산자를 보려면 쿼리 연산자를 참고하세요.

쿼리 문자열 예

다음 표에는 공유 드라이브의 몇 가지 기본 쿼리 문자열 예가 나와 있습니다. 실제 코드는 검색에 사용하는 클라이언트 라이브러리에 따라 다릅니다.

또한 쿼리가 올바르게 작동하도록 파일 이름의 특수문자를 이스케이프 처리해야 합니다. 예를 들어 파일 이름에 작은따옴표 (')와 백슬래시 ("\") 문자가 모두 포함된 경우 백슬래시를 사용하여 이스케이프 처리합니다. name contains 'quinn\'s paper\\essay'

쿼리할 항목 예 useDomainAdminAccess 설정
문자열 일치 연산자 (contains)
사용자가 회원인 모든 공유 드라이브 중에서 제목에 'confidential'이라는 단어가 포함된 공유 드라이브 name contains 'confidential' false
동등성 및 비동등성 연산자 (=, !=)
기본 뷰에 표시되는 공유 드라이브 hidden = false false
기본 뷰에서 숨겨진 공유 드라이브 hidden = true false
할당된 주최자가 없는 공유 드라이브 organizerCount = 0 true
회원이 정확히 1명인 공유 드라이브 memberCount = 1 true
조직 단위 ID에 속하는 공유 드라이브 orgUnitId = 'C03az79cb' true
조직 단위 ID가 포함되지 않은 공유 드라이브 orgUnitId != 'C03az79cb' true
이름이 특정 이름과 일치하지 않는 공유 드라이브 name != 'Archived Projects' true
비교 연산자 (>, >=, <, <=)
2017년 6월 1일 이후에 생성된 공유 드라이브 createdTime > '2017-06-01T12:00:00' true
2023년 1월 1일 이전에 생성된 공유 드라이브 createdTime < '2023-01-01T00:00:00' true
회원이 2명 이상인 공유 드라이브 memberCount > 1 true
회원이 5명 미만인 공유 드라이브 memberCount < 5 true
주최자가 3명 이하인 공유 드라이브 organizerCount <= 3 true
논리 연산자 (and, or, not)
제목에 'confidential'이라는 단어가 포함되고 회원이 20명 이상인 공유 드라이브 name contains 'confidential' and memberCount >= 20 true
조직의 모든 공유 드라이브 중에서 제목에 'confidential'이라는 단어가 포함된 공유 드라이브 name contains 'confidential' and orgUnitId = 'C03az79cb' true
이름에 'Project' 또는 'Archive'가 포함된 공유 드라이브 name contains 'Project' or name contains 'Archive' true
이름에 'Draft'가 포함되지 않은 공유 드라이브 not name contains 'Draft' true
타겟 조직 단위에 속하지 않고 특정 날짜 이후에 생성된 공유 드라이브 orgUnitId != 'C03az79cb' and createdTime > '2023-01-01T00:00:00' true

괄호로 여러 용어 쿼리

괄호를 사용하여 여러 쿼리 용어를 함께 그룹화할 수 있습니다. 예를 들어 특정 날짜 이후에 생성되고 주최자가 5명 이상이거나 회원이 20명 이상인 공유 드라이브를 검색하려면 다음 쿼리를 사용합니다.

createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or memberCount > 20)

이 검색은 2019년 1월 1일 이후에 생성되고 주최자가 5명 이상이거나 회원이 20명 이상인 모든 공유 드라이브를 반환합니다.

Drive API는 and 및 or 연산자를 왼쪽에서 오른쪽으로 평가하므로 괄호가 없는 동일한 검색은 다음을 반환합니다.

  • 2019년 1월 1일 이후에 생성된 주최자가 5명 이상인 공유 드라이브만 해당합니다.
  • 2019년 1월 1일 이전에 생성된 공유 드라이브를 포함하여 회원이 20명 이상인 모든 공유 드라이브가 해당합니다.