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

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

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

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

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

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

query_term operator values

โดยที่

  • query_term คือคำค้นหาหรือช่องที่จะค้นหา

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

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

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

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

โอเปอเรเตอร์ การใช้งาน
contains เนื้อหาของสตริงหนึ่งมีอยู่ในอีกสตริงหนึ่ง
= เนื้อหาของสตริงหรือบูลีนเท่ากับอีกสตริงหนึ่ง
!= เนื้อหาของสตริงหรือบูลีนไม่เท่ากับอีกสตริงหนึ่ง
< ค่าหนึ่งน้อยกว่าอีกค่าหนึ่ง
<= ค่าหนึ่งน้อยกว่าหรือเท่ากับอีกค่าหนึ่ง
> ค่าหนึ่งมากกว่าอีกค่าหนึ่ง
>= ค่าหนึ่งมากกว่าหรือเท่ากับอีกค่าหนึ่ง
in องค์ประกอบหนึ่งอยู่ในคอลเล็กชัน
and แสดงรายการที่ตรงกับการค้นหาทั้ง 2 รายการ
or แสดงรายการที่ตรงกับการค้นหาอย่างน้อย 1 รายการ
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 รองรับใน 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

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