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

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

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