如要搜尋一組特定共用雲端硬碟,請使用查詢字串 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 設定 |
---|---|---|
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 日後建立,且擁有超過五位發起人或超過 20 位成員的共用雲端硬碟。
Drive API 會從左到右評估 and
和 or
運算子,因此相同的搜尋不含括號:
- 只有在 2019 年 1 月 1 日後建立且發起人超過五次的共用雲端硬碟的共用雲端硬碟。
- 所有成員超過 20 人的共用雲端硬碟,包括 2019 年 1 月 1 日之前建立的所有共用雲端硬碟。