本參考指南提供的查詢字詞和運算子可以與 使用 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 world 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 |
如需更多查詢字串搜尋範例,請參閱「共用雲端硬碟查詢字串」 範例。