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

คู่มืออ้างอิงนี้แสดงคำค้นหาและโอเปอเรเตอร์ที่คุณสามารถใช้กับ 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

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