คู่มืออ้างอิงนี้จะระบุคำค้นหาและโอเปอเรเตอร์ที่คุณสามารถใช้กับ Google Drive API เพื่อกรองไฟล์ โฟลเดอร์ และไดรฟ์ที่แชร์ได้
โปรดดูตัวอย่างการค้นหาไฟล์ที่หัวข้อค้นหาไฟล์และโฟลเดอร์
โปรดดูตัวอย่างการค้นหาไดรฟ์ที่แชร์ที่หัวข้อค้นหาไดรฟ์ที่แชร์
ไวยากรณ์สตริงการค้นหา
สตริงการค้นหาประกอบด้วย 3 ส่วนต่อไปนี้
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 ได้ที่ ประเภท MIME ที่ Google Workspace และ Google ไดรฟ์รองรับ |
modifiedTime |
<= , < , = , != , > , >= |
วันที่แก้ไขไฟล์ครั้งล่าสุด รูปแบบ RFC 3339 เขตเวลาเริ่มต้นคือ UTC เช่น 2012-06-04T12:00:00-08:00 ช่องประเภท date ไม่สามารถเปรียบเทียบกันได้ แต่มีเพียงวันที่คงที่เท่านั้น |
viewedByMeTime |
<= , < , = , != , > , >= |
วันที่ที่ผู้ใช้ดูไฟล์ครั้งล่าสุด รูปแบบ RFC 3339 เขตเวลาเริ่มต้นคือ UTC เช่น 2012-06-04T12:00:00-08:00 ช่องประเภท date ไม่สามารถเปรียบเทียบกันได้ แต่มีเพียงวันที่คงที่เท่านั้น |
trashed |
= != |
ไฟล์อยู่ในถังขยะหรือไม่ อาจเป็น true หรือ false ก็ได้ |
starred |
= != |
ไฟล์ติดดาวหรือไม่ อาจเป็น true หรือ false ก็ได้ |
parents |
in |
คอลเล็กชันระดับบนสุดมีรหัสที่ระบุหรือไม่ |
owners |
in |
ผู้ใช้ที่เป็นเจ้าของไฟล์ |
writers |
in |
ผู้ใช้หรือกลุ่มที่มีสิทธิ์แก้ไขไฟล์ โปรดดูข้อมูลอ้างอิงของทรัพยากร permissions |
readers |
in |
ผู้ใช้หรือกลุ่มที่มีสิทธิ์อ่านไฟล์ โปรดดูข้อมูลอ้างอิงของทรัพยากร permissions |
sharedWithMe |
= != |
ไฟล์ที่อยู่ในคอลเล็กชัน "แชร์กับฉัน" ของผู้ใช้ ผู้ใช้ไฟล์ทั้งหมดจะอยู่ใน Access Control List (ACL) ของไฟล์ อาจเป็น true หรือ false ก็ได้ |
createdTime |
<= , < , = , != , > , >= |
วันที่สร้างไดรฟ์ที่แชร์ ใช้รูปแบบ RFC 3339 โดยเขตเวลาเริ่มต้นคือ UTC เช่น 2012-06-04T12:00:00-08:00 |
properties |
has |
พร็อพเพอร์ตี้ไฟล์ที่กำหนดเองแบบสาธารณะ |
appProperties |
has |
พร็อพเพอร์ตี้ไฟล์ที่กำหนดเองแบบเป็นส่วนตัว |
visibility |
= != |
ระดับการมองเห็นไฟล์ ค่าที่ถูกต้องคือ anyoneCanFind , anyoneWithLink , domainCanFind , domainWithLink และ limited ล้อมรอบด้วยเครื่องหมายคำพูดเดี่ยว (' ) |
shortcutDetails.targetId |
= != |
รหัสของรายการที่ทางลัดชี้ไป |
ตัวอย่างต่อไปนี้แสดงชุดค่าผสมโอเปอเรเตอร์และข้อความค้นหา
โอเปอเรเตอร์
contains
จะดำเนินการจับคู่คำนำหน้าสำหรับคำศัพท์name
เท่านั้น ตัวอย่างเช่น สมมติว่าคุณมีชื่อHelloWorld
คำค้นหาname contains 'Hello'
จะแสดงผลลัพธ์ แต่คำค้นหาname contains 'World'
ไม่แสดงผลโอเปอเรเตอร์
contains
จะจับคู่โทเค็นสตริงทั้งโทเค็นสำหรับคำศัพท์fullText
เท่านั้น เช่น หากข้อความทั้งหมดของเอกสารมีสตริง "สวัสดีโลก" จะมีเพียงคำค้นหาfullText contains 'HelloWorld'
เท่านั้นที่แสดงผลลัพธ์โอเปอเรเตอร์
contains
จะจับคู่กับวลีที่เป็นตัวอักษรและตัวเลขคละกันตรงทุกประการหากอยู่ในเครื่องหมายคำพูดคู่ ตัวอย่างเช่น หากfullText
ของเอกสารมีสตริง "สวัสดีทุกคน" คำค้นหาfullText contains '"Hello there"'
จะแสดงผลลัพธ์ แต่คำค้นหาfullText contains '"Hello world"'
ไม่แสดงผล นอกจากนี้ เนื่องจากการค้นหาเป็นตัวอักษรและตัวเลขคละกัน หากข้อความทั้งหมดของเอกสารมีสตริง " Hello_world" การค้นหาfullText contains '"Hello world"'
จะแสดงผลลัพธ์ข้อกำหนดของ
owners
,writers
และreaders
จะปรากฏในรายการpermissions
และอ้างอิงrole
ในสิทธิ์ ดูรายการสิทธิ์ทั้งหมดของบทบาทได้ที่บทบาทและสิทธิ์
ดูตัวอย่างเพิ่มเติมของการค้นหาสตริงคำค้นหาได้ในตัวอย่างสตริงคำค้นหา
คำค้นหาเฉพาะไดรฟ์ที่แชร์
ตารางต่อไปนี้แสดงคำค้นหาที่ถูกต้องทั้งหมดของไดรฟ์ที่แชร์ โปรดดูประเภทข้อมูลและคำอธิบาย
ในข้อมูลอ้างอิงของ
แหล่งข้อมูล drives
คำค้นหา | โอเปอเรเตอร์ที่ถูกต้อง | การใช้งาน | การตั้งค่า useDomainAdminAccess |
---|---|---|---|
createdTime |
<= , < , = , != , > , >= |
วันที่สร้างไดรฟ์ที่แชร์ รูปแบบ RFC 3339 เขตเวลาเริ่มต้นคือ UTC เช่น 2012-06-04T12:00:00-08:00 |
true |
hidden |
= != |
ระบุว่าไดรฟ์ที่แชร์ซ่อนอยู่หรือไม่ อาจเป็น true หรือ false ก็ได้ |
false |
memberCount |
<= , < , = , != , > , >= |
จำนวนผู้ใช้และกลุ่มที่เป็นสมาชิกของไดรฟ์ที่แชร์ ใช้ค่าตัวเลข | true |
name |
contains , = , != |
ชื่อไดรฟ์ที่แชร์ ล้อมรอบด้วยเครื่องหมายคำพูดเดี่ยว (' ) ใช้อักขระหลีกกับเครื่องหมายคำพูดเดี่ยวในข้อความค้นหาด้วย \' เช่น 'Valentine\'s Day' |
true |
organizerCount |
<= , < , = , != , > , >= |
จำนวนผู้ใช้และกลุ่มที่เป็นผู้จัดไดรฟ์ที่แชร์ ใช้ค่าตัวเลข | true |
orgUnitId |
= != |
รหัสหน่วยขององค์กรของไดรฟ์ที่แชร์ ใช้ค่าสตริง | true |
ดูตัวอย่างเพิ่มเติมของการค้นหาสตริงการค้นหาได้ที่ตัวอย่างสตริงคําค้นหาของไดรฟ์ที่แชร์
หัวข้อที่เกี่ยวข้อง
- ค้นหาไฟล์และโฟลเดอร์
- ค้นหาไดรฟ์ที่แชร์
- ประเภท MIME ที่รองรับใน Google Workspace และ Google ไดรฟ์
- บทบาทและสิทธิ์