本參考指南提供查詢字詞和運算子，可與 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 |
name、description、indexableText 屬性，或檔案內容或檔案中繼資料中的文字是否相符。請用單引號 (') 括住。如要逸出查詢中的單引號，請使用 \'，例如 'Valentine\'s Day'。 |
mimeType |
contains、=、!= |
檔案的 MIME 類型。請用單引號 (') 括住。如要逸出查詢中的單引號，請使用 \'，例如 'Valentine\'s Day'。如要進一步瞭解 MIME 類型，請參閱「Google Workspace 和 Google 雲端硬碟支援的 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 |
parents 集合是否包含指定 ID。只會檢查直接上層資料夾，不會比對間接上層資料夾。 |
owners |
in |
檔案擁有者。 |
writers |
in |
有權修改檔案的使用者或群組。請參閱 permissions 資源參考資料。 |
readers |
in |
有權讀取檔案的使用者或群組。請參閱 permissions 資源參考資料。 |
sharedWithMe |
=、!= |
使用者「與我共用」集合中的檔案。所有檔案使用者都會列在檔案的存取控管清單 (ACL) 中。可以是 true 或 false。 |
createdTime |
<=，<，=，!=，>，>= |
檔案建立日期。請使用 RFC 3339 格式，預設時區為世界標準時間，例如 2012-06-04T12:00:00-08:00。僅支援 Drive API v3。 |
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條款會間接反映在permissions清單中，並參照權限的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'。 |
true |
organizerCount |
<=，<，=，!=，>，>= |
共用雲端硬碟管理員的使用者和群組數量。接受數值。 | true |
orgUnitId |
=、!= |
共用雲端硬碟的組織單位 ID。接受字串值。 | true |
如需更多查詢字串搜尋範例，請參閱共用雲端硬碟查詢字串範例。