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

คู่มืออ้างอิงนี้มีข้อความค้นหาและตัวดำเนินการที่คุณใช้กับ 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 คอลเล็กชันขององค์ประกอบหลักมีรหัสที่ระบุหรือไม่
owners in ผู้ใช้ที่เป็นเจ้าของไฟล์
writers in ผู้ใช้หรือกลุ่มที่มีสิทธิ์แก้ไขไฟล์ ดูข้อมูลอ้างอิงของทรัพยากร permissions
readers in ผู้ใช้หรือกลุ่มที่มีสิทธิ์อ่านไฟล์ ดูข้อมูลอ้างอิงของทรัพยากร permissions
sharedWithMe =, != ไฟล์ที่อยู่ในคอลเล็กชัน "แชร์กับฉัน" ของผู้ใช้ ผู้ใช้ไฟล์ทั้งหมดอยู่ในรายการควบคุมการเข้าถึง (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 ตัวอย่างเช่น หากข้อความแบบเต็มของเอกสารมีสตริง "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

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