คำค้นหาและโอเปอเรเตอร์

คู่มืออ้างอิงนี้จะระบุคำค้นหาและโอเปอเรเตอร์ที่คุณสามารถใช้กับ 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

ดูตัวอย่างเพิ่มเติมของการค้นหาสตริงการค้นหาได้ที่ตัวอย่างสตริงคําค้นหาของไดรฟ์ที่แชร์