หน้านี้จะอธิบายวิธีค้นหาไฟล์ที่มีป้ายกำกับหรือค่าในช่องที่เฉพาะเจาะจง ใช้แล้ว
ประเภทช่องป้ายกำกับ
ช่องป้ายกำกับของ 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, =, != |
รายการสิ่งที่เลือก | ตัวเลือกการเลือก (มี 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. ค้นหาตามช่องที่มีค่าเดียว
คุณเขียนคำค้นหาให้ตรงกับค่าในช่องที่คาดหวังได้ ตารางต่อไปนี้ แสดงการค้นหาช่องที่ถูกต้อง:
สิ่งที่คุณต้องการค้นหา | สตริงการค้นหา |
---|---|
รายการที่ตั้งค่าความคิดเห็นเป็น "สวัสดี" | labels/contract.comment = 'hello' |
ไฟล์ที่ความคิดเห็นขึ้นต้นด้วย "สวัสดี" | labels/contract.comment STARTS WITH 'hello' |
ไฟล์ที่มีการดำเนินการสถานะ | labels/contract.status = 'executed' |
ไฟล์ที่ไม่มีการดำเนินการสถานะ | labels/contract.status != 'executed' |
ไฟล์ที่ actions_date อยู่ก่อนวันที่ที่ระบุ | 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
อย่างน้อย 1 รายการเพื่อแสดงรายการทั้งหมด
ซึ่งมีป้ายกำกับหรือค่าในช่องเฉพาะจากไฟล์ในไดรฟ์
แหล่งข้อมูล นอกจากนี้ยังใช้
files.list
เนื้อหาของคำขอต้อง
ว่างเปล่า
ถ้าต้องการใส่ labelInfo
ในการตอบกลับ คุณต้องระบุข้อมูลต่อไปนี้ด้วย
includeLabels
เป็นรายการรหัสที่คั่นด้วยคอมมาlabelInfo
ในพารามิเตอร์fields
เพื่อแสดงว่าคุณต้องการพารามิเตอร์ เงินจำนวนlabelInfo
ส่งคืนภายในincludeLabels
ถ้าสำเร็จ การตอบกลับ content มีรายการ จากทั้งหมด
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
ที่สองของป้ายกำกับที่จะแสดงผล