특정 공유 드라이브 집합을 검색하려면 쿼리 문자열 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 |
괄호를 사용하여 여러 검색어 쿼리
괄호를 사용하여 여러 검색어를 함께 그룹화할 수 있습니다. 예를 들어 특정 날짜 이후에 생성되었으며 더 많은 공유 드라이브가 있는 공유 드라이브를 검색할 수 있습니다 20명을 초과하는 경우 다음 쿼리를 사용합니다.
createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or
memberCount > 20)
이 검색은 2019년 1월 1일 이후에 생성된 모든 공유 드라이브를 반환하며 주최자 5명 이상 또는 회원 20명 이상
Drive API는 and 및 or 연산자를 왼쪽에서 오른쪽으로 평가합니다.
따라서 괄호 없이 동일한 검색은 다음과 같이 반환됩니다.
- 이후에 생성된 주최자가 5개 이상인 공유 드라이브만 해당 2019년 1월 1일
- 멤버가 20명 이상인 모든 공유 드라이브(이전에 만든 공유 드라이브 포함) 2019년 1월 1일