如要搜尋一組特定共用雲端硬碟，請使用查詢字串 q 欄位搭配 drives.list，合併一或多個搜尋字詞來篩選磁碟機以便傳回。
查詢字串包含以下三個部分：
query_term operator values
在此情況下：
query_term是要搜尋的查詢字詞或欄位。operator用於指定查詢字詞的條件。values是您要用於篩選搜尋結果的特定值。
如要查看可用來篩選共用雲端硬碟的查詢字詞和運算子，請參閱「搜尋查詢和運算子」。
舉例來說，下列查詢字串會篩選搜尋，只傳回名稱為「Google Drive API resources」的共用雲端硬碟。
q: name = 'Google Drive API resources' & useDomainAdminAccess=false
查詢字串範例
下表列舉了共用雲端硬碟的一些基本查詢字串範例。實際程式碼會因用於搜尋的用戶端程式庫而異。
| 您想查詢的內容 | 範例 | useDomainAdminAccess設定 |
|---|---|---|
| 2017 年 6 月 1 日後建立的共用雲端硬碟 | createdTime > '2017-06-01T12:00:00' |
true |
| 預設檢視畫面會顯示共用雲端硬碟 | hidden = false |
false |
| 有多位成員的共用雲端硬碟 | 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 運算子，因此沒有括號的相同搜尋會傳回：
- 只有在 2019 年 1 月 1 日之後建立的共用雲端硬碟，而且主辦人人數超過五個。
- 所有成員超過 20 名的共用雲端硬碟，包括在 2019 年 1 月 1 日之前建立。