คู่มืออ้างอิงนี้มีคำค้นหาและโอเปอเรเตอร์ที่คุณสามารถใช้กับ 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 |
ดูตัวอย่างเพิ่มเติมของการค้นหาสตริงการค้นหาได้ในตัวอย่างสตริงการค้นหาไดรฟ์ที่แชร์
หัวข้อที่เกี่ยวข้อง
- ค้นหาไฟล์และโฟลเดอร์
- ค้นหาไดรฟ์ที่แชร์
- ประเภท MIME ที่รองรับ Google Workspace และ Google ไดรฟ์
- บทบาทและสิทธิ์