특정 공유 드라이브 세트를 검색하려면 쿼리 문자열 q
필드와 drives.list
를 사용하여 하나 이상의 검색어를 결합하여 반환할 드라이브를 필터링합니다.
쿼리 문자열에는 다음 세 부분이 포함됩니다.
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일 이후에 생성되었으며 공동작업자가 5명 이상인 공유 드라이브만
- 멤버가 20명 이상인 모든 공유 드라이브(2019년 1월 1일 이전에 생성된 공유 드라이브 포함)