특정 공유 드라이브 집합을 검색하려면 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일 이전에 생성된 공유 드라이브 포함)