특정 공유 드라이브 집합을 검색하려면 drives.list와 함께 쿼리 문자열 q 필드를 사용하여 하나 이상의 검색어를 결합하여 반환할 드라이브를 필터링합니다.
쿼리 문자열은 다음 세 부분으로 구성됩니다.
query_term operator values
각 항목의 의미는 다음과 같습니다.
query_term은 검색할 검색어 또는 필드입니다.operator는 검색어의 조건을 지정합니다.values는 검색 결과를 필터링하는 데 사용할 특정 값입니다.
공유 드라이브를 필터링하는 데 사용할 수 있는 검색어 및 연산자를 보려면 검색어 및 연산자를 참고하세요.
예를 들어 다음 쿼리 문자열은 검색을 필터링하여 이름이 'Google Drive API 리소스'인 공유 드라이브만 반환합니다.
q: name = 'Google Drive API resources' & useDomainAdminAccess=false
쿼리 문자열의 예
다음 표에는 공유 드라이브에 대한 몇 가지 기본 쿼리 문자열의 예가 나와 있습니다. 실제 코드는 검색에 사용하는 클라이언트 라이브러리에 따라 다릅니다.
또한 파일 이름의 특수문자를 이스케이프 처리하여 쿼리가 올바르게 작동하는지 확인해야 합니다. 예를 들어 파일 이름에 아포스트로피(')와 백슬래시("\") 문자가 모두 포함되어 있으면 백슬래시를 사용하여 이를 이스케이프 처리하세요(예: name
contains 'quinn\'s paper\\essay').
| 쿼리하려는 대상 | 예시 | useDomainAdminAccess 설정 |
|---|---|---|
| 2017년 6월 1일 이후에 생성된 공유 드라이브 | createdTime > '2017-06-01T12:00:00' |
true |
| 공유 드라이브가 기본 뷰에 표시됨 | hidden = false |
false |
| 멤버가 2명 이상인 공유 드라이브 | memberCount > 1 |
true |
| 제목에 '기밀'이라는 단어가 있고 멤버가 20명 이상인 공유 드라이브 | name contains 'confidential' and memberCount >= 20 |
true |
| 조직의 모든 공유 드라이브 중 제목에 '기밀'이라는 단어가 포함된 공유 드라이브 | name contains 'confidential' and orgUnitId = 'C03az79cb' |
true |
| 사용자가 속한 모든 공유 드라이브 중 제목에 '기밀'이라는 단어가 포함된 공유 드라이브 | name contains 'confidential' |
false |
| 주최자가 할당되지 않은 공유 드라이브 | organizerCount = 0 |
true |
| 조직 단위 ID가 포함되지 않은 공유 드라이브 | orgUnitId != 'C03az79cb' |
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일 이후에 생성된 주최자가 6개 이상인 공유 드라이브에만 해당됩니다.
- 멤버가 20명 이상인 모든 공유 드라이브(2019년 1월 1일 이전에 생성된 공유 드라이브 포함)