如要搜尋一組特定共用雲端硬碟,請使用查詢字串 q
欄位
使用 drives.list
篩選要經過的磁碟機
傳回的結果。
查詢字串包含以下三個部分:
query_term operator values
在此情況下:
query_term
是要搜尋的查詢字詞或欄位。operator
指定查詢字詞的條件。values
是你想要用來篩選搜尋的特定值 也就是預測結果
如要查看可用來篩選共用雲端硬碟的查詢字詞和運算子, 請參閱「搜尋查詢字詞和運算子」一文。
舉例來說,以下查詢字串會篩選搜尋,只傳回共用項目。 名為「Google Drive API resource」的磁碟。
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 日之後建立, 發起人超過 5 名或超過 20 名成員。
Drive API 會從左到右評估 and
和 or
運算子。
所以沒有括號的搜尋會傳回:
- 只有在共用雲端硬碟中有超過五位主辦人建立後,才成為這個機構 2019 年 1 月 1 日。
- 所有成員超過 20 人的共用雲端硬碟,包括過去建立的成員 2019 年 1 月 1 日。