搜尋查詢字詞和運算子

本參考指南提供的查詢字詞和運算子,可搭配 Google Drive API 用於篩選檔案、資料夾和共用雲端硬碟。

如需檔案搜尋範例,請參閱「搜尋檔案和資料夾」。

如需搜尋共用雲端硬碟的範例,請參閱「搜尋共用雲端硬碟」。

查詢字串語法

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

query_term operator values

在此情況下:

  • query_term 是搜尋的查詢字詞或欄位。

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

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

查詢運算子

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

運算子 用量
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 和 Google 雲端硬碟支援的 MIME 類型」。
modifiedTime <=<=!=>>= 上次修改檔案的日期。RFC 3339 格式,預設時區為世界標準時間,例如 2012-06-04T12:00:00-08:00date 類型的欄位無法相互比較,只能與常數日期比較。
viewedByMeTime <=<=!=>>= 使用者上次查看檔案的日期。RFC 3339 格式,預設時區為世界標準時間,例如 2012-06-04T12:00:00-08:00date 類型的欄位無法相互比較,只能與常數日期比較。
trashed =!= 檔案是否在垃圾桶中。可以是 truefalse
starred =!= 檔案是否已加星號。可以是 truefalse
parents in 父項集合是否包含指定的 ID。
owners in 擁有該檔案的使用者。
writers in 具有修改檔案權限的使用者或群組。請參閱 permissions 資源參考資料。
readers in 擁有檔案讀取權限的使用者或群組。請參閱 permissions 資源參考資料。
sharedWithMe =!= 使用者「與我共用」集合中的檔案。所有檔案的使用者都會列在檔案的存取控制清單 (ACL) 中。可以是 truefalse
createdTime <=<=!=>>= 共用雲端硬碟的建立日期。使用 RFC 3339 格式,預設時區為世界標準時間,例如 2012-06-04T12:00:00-08:00
properties has 公開自訂檔案屬性。
appProperties has 私人自訂檔案屬性。
visibility =!= 檔案的瀏覽權限等級。有效值為 anyoneCanFindanyoneWithLinkdomainCanFinddomainWithLinklimited。請用單引號 (') 括住,
shortcutDetails.targetId =!= 捷徑所指向的項目 ID。

以下示範運算子和查詢字詞組合:

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

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

  • 如果半形雙引號括住的詞組完全相符,contains 運算子就會比對。例如,如果文件的 fullText 包含「Hello world world」字串,則查詢 fullText contains '"Hello there"' 會傳回結果,但查詢 fullText contains '"Hello world"' 不會。此外,由於搜尋內容是英數字元,如果文件的完整文字包含「Hello_world」字串,則查詢 fullText contains '"Hello world"' 會傳回結果。

  • ownerswritersreaders 條款會間接反映在 permissions 清單中,並參照權限上的 role。如需角色權限的完整清單,請參閱「角色和權限」。

如需查詢字串搜尋的其他範例,請參閱檔案查詢字串範例

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

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

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

如需查詢字串搜尋的更多範例,請參閱「共用雲端硬碟查詢字串範例」。