本指南說明 Google Drive API 支援多種搜尋共用雲端硬碟的方式。
如要搜尋特定共用雲端硬碟，請在 q 欄位中使用 drives 資源的 list 方法，透過一或多個搜尋字詞篩選要傳回的雲端硬碟。
查詢字串包含下列三個部分：
query_term operator values
其中：
query_term是要搜尋的查詢字詞或欄位。operator指定查詢字詞的條件。values是要用來篩選搜尋結果的特定值。
舉例來說，下列查詢字串會篩選搜尋結果，只傳回名稱為「Google Drive API resources」的共用雲端硬碟。
q: name = 'Google Drive API resources' & useDomainAdminAccess=false
如要查看所有共用雲端硬碟查詢條件，請參閱「共用雲端硬碟專屬查詢條件」。
如要查看可用於建構查詢的所有查詢運算子，請參閱「查詢運算子」。
查詢字串範例
下表列出共用雲端硬碟的一些基本查詢字串範例。實際程式碼會因您用於搜尋的用戶端程式庫而異。
此外，您也必須逸出檔案名稱中的特殊字元，確保查詢作業正常運作。舉例來說，如果檔案名稱同時包含單引號 (') 和反斜線 ("\") 字元，請使用反斜線逸出這些字元：name
contains 'quinn\'s paper\\essay'。
| 可查詢的內容 | 範例 | useDomainAdminAccess設定 |
|---|---|---|
字串比對運算子 (contains) |
||
| 使用者所屬共用雲端硬碟中，標題含有「機密」一詞的共用雲端硬碟 | name contains 'confidential' |
false |
相等和不相等運算子 (=、!=) |
||
| 預設檢視畫面中顯示的共用雲端硬碟 | hidden = false |
false |
| 從預設檢視畫面隱藏共用雲端硬碟 | hidden = true |
false |
| 沒有指派主辦者的共用雲端硬碟 | organizerCount = 0 |
true |
| 只有一位成員的共用雲端硬碟 | memberCount = 1 |
true |
| 屬於組織單位 ID 的共用雲端硬碟 | orgUnitId = 'C03az79cb' |
true |
| 不含組織單位 ID 的共用雲端硬碟 | orgUnitId != 'C03az79cb' |
true |
| 名稱與特定名稱不符的共用雲端硬碟 | name != 'Archived Projects' |
true |
比較運算子 (>、>=、<、<=) |
||
| 2017 年 6 月 1 日後建立的共用雲端硬碟 | createdTime > '2017-06-01T12:00:00' |
true |
| 2023 年 1 月 1 日前建立的共用雲端硬碟 | createdTime < '2023-01-01T00:00:00' |
true |
| 有多位成員的共用雲端硬碟 | memberCount > 1 |
true |
| 成員少於 5 人的共用雲端硬碟 | memberCount < 5 |
true |
| 主辦人少於 3 位的共用雲端硬碟 | organizerCount <= 3 |
true |
邏輯運算子 (and、or、not) |
||
| 標題中含有「機密」一詞，且成員人數達到或超過 20 人的共用雲端硬碟 | name contains 'confidential' and memberCount >= 20 |
true |
| 機構所有共用雲端硬碟中，標題含有「機密」一詞的共用雲端硬碟 | name contains 'confidential' and orgUnitId = 'C03az79cb' |
true |
| 名稱含有「Project」或「Archive」的共用雲端硬碟 | name contains 'Project' or name contains 'Archive' |
true |
| 名稱不含「草稿」的共用雲端硬碟 | not name contains 'Draft' |
true |
| 不屬於目標組織單位，且在特定日期後建立的共用雲端硬碟 | orgUnitId != 'C03az79cb' and createdTime > '2023-01-01T00:00:00' |
true |
使用半形括號查詢多個字詞
您可以使用括號將多個查詢字詞歸類為一組。舉例來說，如要搜尋在特定日期之後建立，且有超過五位主辦人或超過 20 位成員的共用雲端硬碟，請使用以下查詢：
createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or memberCount > 20)
這項搜尋會傳回 2019 年 1 月 1 日後建立的所有共用雲端硬碟，以及擁有超過五位主辦人或超過 20 位成員的共用雲端硬碟。
Drive API 會從左到右評估 and 和 or 運算子，因此如果沒有括號，相同的搜尋會傳回：
- 只有在 2019 年 1 月 1 日後建立，且有超過五位主辦人的共用雲端硬碟。
- 所有成員超過 20 人的共用雲端硬碟，包括 2019 年 1 月 1 日前建立的共用雲端硬碟。