搜尋共用雲端硬碟

如要搜尋特定的共用雲端硬碟組合,請使用查詢字串 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
有多位成員的共用雲端硬碟 memberCount > 1 true
標題含有「confidential」一詞且成員人數達 20 位以上的共用雲端硬碟 name contains 'confidential' and memberCount >= 20 true
機構中所有共用雲端硬碟中,標題含有「confidential」一詞的共用雲端硬碟 name contains 'confidential' and orgUnitId = 'C03az79cb' true
在使用者所屬的所有共用雲端硬碟中,標題含有「confidential」一詞的共用雲端硬碟 name contains 'confidential' false
未指派管理員的共用雲端硬碟 organizerCount = 0 true
不含機構單位 ID 的共用雲端硬碟 orgUnitId != 'C03az79cb' true

使用括號查詢多個字詞

您可以使用括號將多個查詢字詞組合在一起。舉例來說,如要搜尋在特定日期之後建立的共用雲端硬碟,且該雲端硬碟有超過 5 位發起人或 20 位成員,請使用以下查詢:

createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or
memberCount > 20)

這項搜尋會傳回 2019 年 1 月 1 日後建立的所有共用雲端硬碟,且該雲端硬碟的發起人或成員人數皆超過 5 人或 20 人。

Drive API 會從左到右評估 andor 運算子,因此相同的搜尋內容如果沒有括號,會傳回以下結果:

  • 只有在 2019 年 1 月 1 日後建立的共用雲端硬碟,且擁有超過五位管理員。
  • 所有共用雲端硬碟 (成員人數超過 20 人),包括 2019 年 1 月 1 日前建立的共用雲端硬碟。