查詢字串包含以下 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 |