本參考指南提供查詢字詞和運算子,您可以使用 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 |
父項集合是否包含指定 ID。 |
owners |
in |
擁有該檔案的使用者。 |
writers |
in |
具有檔案修改權限的使用者或群組。請參閱 permissions 資源參考資料。 |
readers |
in |
有權讀取該檔案的使用者或群組。請參閱 permissions 資源參考資料。 |
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」字串,查詢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 |
如需更多查詢字串搜尋範例,請參閱共用雲端硬碟查詢字串範例。