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

คู่มืออ้างอิงนี้มีคำค้นหาและโอเปอเรเตอร์ที่คุณใช้กับ Google Drive API เพื่อกรองไฟล์ โฟลเดอร์ และไดรฟ์ที่แชร์

ดูตัวอย่างการค้นหาไฟล์ได้ที่ค้นหาไฟล์และ โฟลเดอร์

ดูตัวอย่างการค้นหาไดรฟ์ที่แชร์ได้ที่ ค้นหาไดรฟ์ที่แชร์

ไวยากรณ์สตริงการค้นหา

สตริงการค้นหาประกอบด้วย 3 ส่วนต่อไปนี้

query_term operator values

โดยที่

  • query_term คือคำค้นหาหรือฟิลด์ที่จะค้นหา

  • operator ระบุเงื่อนไขสำหรับคำค้นหา

  • values คือค่าเฉพาะที่คุณต้องการใช้เพื่อกรองผลการค้นหา

โอเปอเรเตอร์การค้นหา

ตารางต่อไปนี้แสดงโอเปอเรเตอร์การค้นหาที่ใช้ได้

โอเปอเรเตอร์ การใช้งาน
contains เนื้อหาของสตริงหนึ่งปรากฏในอีกสตริงหนึ่ง
= เนื้อหาของสตริงหรือบูลีนเท่ากับอีกสตริงหนึ่ง
!= เนื้อหาของสตริงหรือบูลีนไม่เท่ากับอีกสตริงหนึ่ง
< ค่าหนึ่งน้อยกว่าอีกค่าหนึ่ง
<= ค่าหนึ่งน้อยกว่าหรือเท่ากับอีกค่าหนึ่ง
> ค่าหนึ่งมากกว่าอีกค่าหนึ่ง
>= ค่าหนึ่งมากกว่าหรือเท่ากับอีกค่าหนึ่ง
in องค์ประกอบหนึ่งอยู่ในคอลเล็กชัน
and แสดงรายการที่ตรงกับการค้นหาทั้ง 2 รายการ
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 ระบุว่าคอลเล็กชัน parents มีรหัสที่ระบุหรือไม่ ตรวจสอบเฉพาะโฟลเดอร์หลักโดยตรง ไม่ตรงกับโฟลเดอร์บรรพบุรุษโดยอ้อม
owners in ผู้ใช้ที่เป็นเจ้าของไฟล์
writers in ผู้ใช้หรือกลุ่มที่มีสิทธิ์แก้ไขไฟล์ ดูเอกสารอ้างอิงทรัพยากร permissions
readers in ผู้ใช้หรือกลุ่มที่มีสิทธิ์อ่านไฟล์ ดูเอกสารอ้างอิงทรัพยากร permissions
sharedWithMe =, != ไฟล์ที่อยู่ในคอลเล็กชัน "แชร์กับฉัน" ของผู้ใช้ ผู้ใช้ไฟล์ทั้งหมดอยู่ในรายการควบคุมการเข้าถึง (ACL) ของไฟล์ สามารถเป็น true หรือ false
createdTime <=, <, =, !=, >, >= วันที่สร้างไฟล์ ใช้รูปแบบ RFC 3339 เขตเวลาเริ่มต้นคือ UTC เช่น 2012-06-04T12:00:00-08:00 รองรับใน Drive API v3 เท่านั้น
properties has พร็อพเพอร์ตี้ไฟล์ที่กำหนดเองแบบสาธารณะ
appProperties has พร็อพเพอร์ตี้ไฟล์ที่กำหนดเองแบบส่วนตัว
visibility =, != ระดับการแชร์ของไฟล์ ค่าที่ใช้ได้คือ anyoneCanFind, anyoneWithLink, domainCanFind, domainWithLink และ limited ล้อมรอบด้วยเครื่องหมายคำพูดเดี่ยว (')
shortcutDetails.targetId =, != รหัสของรายการที่ทางลัดชี้ไป

ตัวอย่างต่อไปนี้แสดงการผสมผสานโอเปอเรเตอร์และคำค้นหา

  • โอเปอเรเตอร์ contains จะทำการจับคู่คำนำหน้าสำหรับคำ name เท่านั้น เช่น สมมติว่าคุณมีชื่อ HelloWorld คำค้นหา name contains 'Hello' จะแสดง ผลลัพธ์ แต่คำค้นหา name contains 'World' จะไม่แสดงผลลัพธ์

  • โอเปอเรเตอร์ contains จะทำการจับคู่โทเค็นสตริงทั้งหมดสำหรับคำ fullText เท่านั้น เช่น หากข้อความทั้งหมดของเอกสารมี สตริง "HelloWorld" เฉพาะคำค้นหา fullText contains 'HelloWorld' เท่านั้นที่จะแสดงผลลัพธ์

  • โอเปอเรเตอร์ contains จะจับคู่วลีหากตัวถูกดำเนินการทางด้านขวาล้อมรอบด้วยเครื่องหมายคำพูดคู่ เช่น

    • หาก fullText ของเอกสารมีสตริง "Hello there 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 เขตเวลาเริ่มต้นคือ 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

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