本頁說明如何搜尋含有特定標籤或欄位值的檔案 已套用。
標籤欄位類型
使用強式輸入每個類型支援的 Google 雲端硬碟標籤欄位 不同的索引和搜尋語意下表列出 以及資料類型
類型 | 標籤類型選項 | 支援的搜尋運算子 |
---|---|---|
文字 | TextOptions | is null, is not null, =, contains, starts with |
詳細文字 | LongTextOptions | is null, is not null, contains |
整數 | IntegerOptions | is null, is not null, =, !=, <, >, <=, >= |
日期 | DateOptions | is null, is not null, =, !=, <, >, <=, >= |
選取 | SelectionOptions | is null, is not null, =, != |
使用者 | UserOptions | is null, is not null, =, != |
選項清單 | SelectOptions (含 max_entries > 1) | is null, is not null, in, not in |
使用者名單 | UserOptions (含 max_entries > 1) | is null, is not null, in, not in |
搜尋範例
1. 依據標籤或欄位是否存在搜尋
您可以搜尋已套用 (或未套用特定標籤) 的項目:
'labels/contract' in labels
not 'labels/contract' in labels
您也可以搜尋已設定 (或未設定) 特定欄位的項目:
labels/contract.comment IS NOT NULL
labels/contract.comment IS NULL
2. 依據單值欄位搜尋
您可以撰寫搜尋查詢,比對預期的欄位值。下表 會顯示有效的欄位查詢:
要查詢的內容 | 查詢字串 |
---|---|
留言設定為「Hello」的項目 | labels/contract.comment = 'hello' |
註解開頭為「hello」的檔案 | labels/contract.comment STARTS WITH 'hello' |
執行狀態的檔案 | labels/contract.status = 'executed' |
未執行狀態的檔案 | labels/contract.status != 'executed' |
執行日期早於特定日期的檔案 | labels/contract.execution_date < '2020-06-22' |
其中 value_usd (整數) 小於特定值的檔案 | labels/contract.value_usd < 2000 |
將 client_contact 設為特定電子郵件地址的檔案 | labels/contract.client_contact = 'alex@altostrat.com' |
3.依據含有多值欄位的欄位搜尋 (例如 ListOptions.max_entries >1)。
支援多個值的欄位只能使用 IN 運算子進行查詢:
'EMAIL_ADDRESS' IN labels/project.project_leads
NOT 'EMAIL_ADDRESS' IN labels/project.project_leads
範例
以下程式碼範例說明如何使用一或多個 labelId
列出所有
裝置上含有特定標籤或欄位值的檔案
資源此元件也會使用
files.list
方法,增加圍繞地圖邊緣的邊框間距。要求主體必須
空白。
如要在回應中加入 labelInfo
,您必須一併指定:
includeLabels
以半形逗號分隔的 ID 清單fields
參數中的labelInfo
,表示您想使用labelInfo
在includeLabels
內傳回。
如果成功, body 包含清單 檔案。
Java
List<File> fileList = driveService.files().list().setIncludeLabels("LABEL_1_ID,LABEL_2_ID").setFields("items(labelInfo, id)").setQ("'labels/LABEL_1_ID' in labels and 'labels/LABEL_2_ID' in labels").execute().getItems();
Python
file_list = drive_service.files().list(includeLabels="LABEL_1_ID,LABEL_2_ID", q="'labels/LABEL_1_ID' in labels and 'labels/LABEL_2_ID' in labels", fields="items(labelInfo, id)").execute();
Node.js
/**
* Search for Drive files with specific labels
* @return{obj} file list with labelInfo
**/
async function searchForFileWithLabels() {
// Get credentials and build service
// TODO (developer) - Use appropriate auth mechanism for your app
const {GoogleAuth} = require('google-auth-library');
const {google} = require('googleapis');
const auth = new GoogleAuth({scopes: 'https://www.googleapis.com/auth/drive'});
const service = google.drive({version: 'v3', auth});
try {
const fileList = await service.files.list({
includeLabels: 'LABEL_1_ID,LABEL_2_ID',
q: '\'labels/LABEL_1_ID\' in labels and \'labels/LABEL_2_ID\' in labels',
fields:'files(labelInfo, id)',
});
return file;
} catch (err) {
// TODO (developer) - Handle error
throw err;
}
更改下列內容:
- LABEL_1_ID:要傳回的標籤的前
labelId
。 - LABEL_2_ID:要傳回的標籤的第二個
labelId
。