搜尋查詢字詞和運算子

查詢字串包含以下 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	檔案內容或中繼資料中的 name、description、indexableText 屬性或文字是否相符。用單引號 ' 包圍。在包含 \' 的查詢中逸出單引號，例如 '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	!==	檔案是否在垃圾桶中。可以是 true 或 false。
starred	!==	檔案是否加上星號。可以是 true 或 false。
parents	in	父項集合是否包含指定的 ID。
owners	in	擁有檔案的使用者。
writers	in	有權修改檔案的使用者或群組。請參閱權限資源參考資料。
readers	in	具有檔案讀取權限的使用者或群組。請參閱權限資源參考資料。
sharedWithMe	!==	使用者「與我共用」集合中的檔案。所有使用者清單都列在檔案存取控制清單 (ACL) 中。可以是 true 或 false。
createdTime	<=、<、=、!=、>、>=	共用雲端硬碟的建立日期。使用 RFC 3339 格式，預設時區為世界標準時間，例如 2012-06-04T12:00:00-08:00。
properties	has	公開自訂檔案屬性。
appProperties	has	私人自訂檔案屬性。
visibility	!==	檔案的瀏覽權限層級。有效值為 anyoneCanFind、anyoneWithLink、domainCanFind、domainWithLink 和 limited。用單引號 ' 包圍。
shortcutDetails.targetId	!==	捷徑指向的項目 ID。

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

• contains 運算子只會針對 name 字詞執行前置字串比對。舉例來說，假設您的名稱是 HelloWorld。name 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"' 會傳回結果。

• owners、writers，以及 readers 字詞間接反映於權限清單中，並參照權限中的 role。

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

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

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

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