搜尋查詢字詞和運算子

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

查詢字串包含以下 3 個部分:

query_term operator values

在此情況下:

  • 「query_term」是要搜尋的字詞或欄位。

  • operator 會指定查詢字詞的條件。

  • 「values」是您要用來篩選搜尋結果的特定值。

此參考資料提供可與 Google Drive API 搭配使用的查詢字詞和運算子。

查詢運算子

下表列出所有有效的查詢運算子:

運算子 用量
contains 另一個字串的內容會出現在另一個字串中。
= 字串或布林值的內容與其他物件相同。
!= 字串或布林值的內容彼此不同。
< 值小於其他值。
<= 值小於或等於另一個值。
> 值大於另一個值。
>= 值大於或等於其他值。
in 集合中包含一個元素。
and 傳回同時符合兩項查詢條件的項目。
or 傳回符合其中一個查詢的項目。
not 忽略搜尋查詢。
has 集合包含符合參數的元素。

檔案特定查詢字詞

下表列出所有有效的檔案查詢字詞。如需資料類型和說明,請參閱 files 資源參考資料。

查詢字詞 有效的運算子 用量
name != 年取得contains=學位 檔案名稱。用單引號 ' 包圍。在包含 \' 的查詢中逸出單引號,例如 'Valentine\'s Day'
fullText contains 檔案內容或中繼資料中的 namedescriptionindexableText 屬性或文字是否相符。用單引號 ' 包圍。在包含 \' 的查詢中逸出單引號,例如 'Valentine\'s Day'
mimeType != 年取得contains=學位 檔案的 MIME 類型。用單引號 ' 包圍。在包含 \' 的查詢中逸出單引號,例如 'Valentine\'s Day'。如要進一步瞭解 MIME 類型,請參閱 Google Workspace 和雲端硬碟 MIME 類型
modifiedTime <=<=!=>>= 檔案上次修改的日期。RFC 3339 格式,預設時區為世界標準時間,例如 2012-06-04T12:00:00-08:00。「date」類型的欄位目前無法互相比較,只能與固定日期一致。
viewedByMeTime <=<=!=>>= 使用者上次檢視檔案的日期。RFC 3339 格式,預設時區為世界標準時間,例如 2012-06-04T12:00:00-08:00。「date」類型的欄位目前無法互相比較,只能與固定日期一致。
trashed !== 檔案是否在垃圾桶中。可以是 truefalse
starred !== 檔案是否加上星號。可以是 truefalse
parents in 父項集合是否包含指定的 ID。
owners in 擁有檔案的使用者。
writers in 有權修改檔案的使用者或群組。請參閱權限資源參考資料。
readers in 具有檔案讀取權限的使用者或群組。請參閱權限資源參考資料。
sharedWithMe !== 使用者「與我共用」集合中的檔案。所有使用者清單都列在檔案存取控制清單 (ACL) 中。可以是 truefalse
createdTime <=<=!=>>= 共用雲端硬碟的建立日期。使用 RFC 3339 格式,預設時區為世界標準時間,例如 2012-06-04T12:00:00-08:00
properties has 公開自訂檔案屬性。
appProperties has 私人自訂檔案屬性。
visibility !== 檔案的瀏覽權限層級。有效值為 anyoneCanFindanyoneWithLinkdomainCanFinddomainWithLinklimited。用單引號 ' 包圍。
shortcutDetails.targetId !== 捷徑指向的項目 ID。

以下介紹運算子和查詢字詞的組合:

  • contains 運算子只會針對 name 字詞執行前置字串比對。舉例來說,假設您的名稱是 HelloWorldname contains 'Hello' 查詢會傳回結果,但 name contains 'World' 的查詢不會傳回結果。

  • contains 運算子只會針對 fullText 字詞執行整個字串符記的比對作業。舉例來說,如果文件的全文含有字串「HelloWorld」,則只有查詢 fullText contains 'HelloWorld' 會傳回結果。

  • contains 運算子如果與雙引號包圍,則該字詞使用完全比對英數字元組合。舉例來說,如果文件的 fullText 包含「Hello there world」字串,則查詢 fullText contains '"Hello there"' 會傳回結果,但查詢 fullText contains '"Hello world"' 不會。此外,由於搜尋是英數字元,如果文件的全文包含「Hello_world」字串,則查詢 fullText contains '"Hello world"' 會傳回結果。

  • ownerswriters,以及 readers 字詞間接反映於權限清單中,並參照權限中的 role

如需更多查詢字串搜尋的範例,請參閱查詢字串範例一文。

共用雲端硬碟專用的查詢字詞

下表列出所有有效的共用雲端硬碟查詢字詞。有關資料類型和說明,請參閱 drives 資源參考資料。

查詢字詞 有效的運算子 用量 必要的「useDomainAdminAccess」設定
createdTime <=<=!=>>= 共用雲端硬碟的建立日期。RFC 3339 格式,預設時區為世界標準時間,例如 2012-06-04T12:00:00-08:00 true
hidden !== 指定是否要隱藏共用雲端硬碟。可以是 truefalse false
memberCount <=<=!=>>= 該共用雲端硬碟的成員和群組數量。使用數值。 true
name != 年取得contains=學位 共用雲端硬碟的名稱。用單引號 ' 包圍。在包含 \' 的查詢中逸出單引號,例如 'Valentine\'s Day' false
organizerCount <=<=!=>>= 共用雲端硬碟中發起人的使用者人數和群組數。使用數值。 true
orgUnitId !== 共用雲端硬碟的機構單位 (OU) ID。可接收字串值。 true