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

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

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

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

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

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

query_term operator values

สถานที่:

  • query_term คือคำหรือฟิลด์ค้นหาสำหรับค้นหา

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

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

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

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

โอเปอเรเตอร์ การใช้งาน
contains เนื้อหาของสตริงหนึ่งแสดงอยู่ในอีกสตริงหนึ่ง
= เนื้อหาของสตริงหรือบูลีนเท่ากับรายการอื่น
!= เนื้อหาของสตริงหรือบูลีนไม่เท่ากับรายการอื่น
< ค่าน้อยกว่าค่าอื่น
<= ค่าน้อยกว่าหรือเท่ากับอีกค่าหนึ่ง
> ค่ามากกว่าค่าอื่น
>= ค่ามากกว่าหรือเท่ากับค่าอื่น
in องค์ประกอบอยู่ภายในคอลเล็กชัน
and แสดงรายการที่ตรงกับคำค้นหาทั้ง 2 แบบ
or แสดงรายการที่ตรงกับคำสืบค้นใดคำหนึ่ง
not ลบคำค้นหา
has คอลเล็กชันมีองค์ประกอบที่ตรงกับพารามิเตอร์

คำค้นหาเฉพาะไฟล์

ตารางต่อไปนี้แสดงคำค้นหาไฟล์ที่ถูกต้องทั้งหมด สำหรับประเภทข้อมูลและ คำอธิบาย โปรดดูแหล่งข้อมูล files ข้อมูลอ้างอิง

คำค้นหา โอเปอเรเตอร์ที่ถูกต้อง การใช้งาน
name contains, =, != ชื่อไฟล์ ล้อมรอบด้วยเครื่องหมายคำพูดเดี่ยว (') Escape เครื่องหมายคำพูดเดี่ยวในการค้นหาด้วย \' เช่น 'Valentine\'s Day'
fullText contains พร็อพเพอร์ตี้ name, description, indexableText หรือข้อความในเนื้อหาหรือข้อมูลเมตาของไฟล์ตรงกันหรือไม่ ล้อมรอบด้วยเครื่องหมายคำพูดเดี่ยว (') Escape เครื่องหมายคำพูดเดี่ยวในการค้นหาด้วย \' เช่น 'Valentine\'s Day'
mimeType contains, =, != ประเภท MIME ของไฟล์ ล้อมรอบด้วยเครื่องหมายคำพูดเดี่ยว (') Escape เครื่องหมายคำพูดเดี่ยวในการค้นหาด้วย \' เช่น '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, =, != ชื่อของไดรฟ์ที่แชร์ ล้อมรอบด้วยเครื่องหมายคำพูดเดี่ยว (') Escape เครื่องหมายคำพูดเดี่ยวในการค้นหาด้วย \' เช่น 'Valentine\'s Day' true
organizerCount <=, <, =, !=, >, >= จำนวนผู้ใช้และกลุ่มที่เป็นผู้จัดไดรฟ์ที่แชร์ เลือกใช้ค่าที่เป็นตัวเลข true
orgUnitId = != รหัสหน่วยขององค์กรของไดรฟ์ที่แชร์ ใช้ค่าสตริง true

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