ค้นหาไดรฟ์ที่แชร์

คู่มือนี้อธิบายวิธีที่ Google Drive API รองรับการค้นหาไดรฟ์ที่แชร์ได้หลายวิธี

หากต้องการค้นหาไดรฟ์ที่แชร์ชุดหนึ่ง ให้ใช้ช่องสตริงการค้นหา q field กับเมธอด list ในทรัพยากร drives เพื่อกรองไดรฟ์ที่จะแสดงผลโดย การรวมข้อความค้นหาอย่างน้อย 1 รายการ

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

query_term operator values

โดยที่

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

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

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

ตัวอย่างเช่น สตริงการค้นหาต่อไปนี้จะกรองการค้นหาเพื่อแสดงเฉพาะไดรฟ์ที่แชร์ที่มีชื่อว่า "Google Drive API resources"

q: name = 'Google Drive API resources' & useDomainAdminAccess=false

หากต้องการดูข้อความค้นหาทั้งหมดของไดรฟ์ที่แชร์ โปรดดู ข้อความค้นหาเฉพาะของไดรฟ์ที่แชร์

หากต้องการดูโอเปอเรเตอร์การค้นหาทั้งหมดที่คุณใช้เพื่อสร้างการค้นหาได้ โปรดดูโอเปอเรเตอร์ การค้นหา

ตัวอย่างสตริงการค้นหา

ตารางต่อไปนี้แสดงตัวอย่างสตริงการค้นหาพื้นฐานบางรายการสำหรับไดรฟ์ที่แชร์ โค้ดจริงจะแตกต่างกันไปตามไลบรารีของไคลเอ็นต์ที่คุณใช้สำหรับการค้นหา

นอกจากนี้ คุณต้องกำหนดเป็นอักขระหลีกสำหรับอักขระพิเศษในชื่อไฟล์เพื่อให้การค้นหาทำงานได้อย่างถูกต้อง ตัวอย่างเช่น หากชื่อไฟล์มีทั้งอะพอสทรอฟี (') และแบ็กสแลช ("\") ให้ใช้แบ็กสแลชเพื่อกำหนดเป็นอักขระหลีก: name contains 'quinn\'s paper\\essay'

สิ่งที่ต้องการค้นหา ตัวอย่าง การตั้งค่า useDomainAdminAccess
โอเปอเรเตอร์การจับคู่สตริง (contains)
ไดรฟ์ที่แชร์ที่มีคำว่า "confidential" ในชื่อจากไดรฟ์ที่แชร์ทั้งหมดที่ผู้ใช้เป็นสมาชิก name contains 'confidential' false
โอเปอเรเตอร์ความเท่ากันและความไม่เท่ากัน (=, !=)
ไดรฟ์ที่แชร์ที่มองเห็นได้ในมุมมองเริ่มต้น hidden = false false
ไดรฟ์ที่แชร์ที่ซ่อนจากมุมมองเริ่มต้น hidden = true false
ไดรฟ์ที่แชร์ที่ไม่มีผู้จัดที่ได้รับมอบหมาย organizerCount = 0 true
ไดรฟ์ที่แชร์ที่มีสมาชิก 1 คน memberCount = 1 true
ไดรฟ์ที่แชร์ที่เป็นของรหัสหน่วยขององค์กร orgUnitId = 'C03az79cb' true
ไดรฟ์ที่แชร์ที่ไม่มีรหัสหน่วยขององค์กร orgUnitId != 'C03az79cb' true
ไดรฟ์ที่แชร์ที่มีชื่อไม่ตรงกับชื่อที่ระบุ name != 'Archived Projects' true
โอเปอเรเตอร์การเปรียบเทียบ (>, >=, <, <=)
ไดรฟ์ที่แชร์ที่สร้างขึ้นหลังจากวันที่ 1 มิถุนายน 2017 createdTime > '2017-06-01T12:00:00' true
ไดรฟ์ที่แชร์ที่สร้างขึ้นก่อนวันที่ 1 มกราคม 2023 createdTime < '2023-01-01T00:00:00' true
ไดรฟ์ที่แชร์ที่มีสมาชิกมากกว่า 1 คน memberCount > 1 true
ไดรฟ์ที่แชร์ที่มีสมาชิกน้อยกว่า 5 คน memberCount < 5 true
ไดรฟ์ที่แชร์ที่มีผู้จัดไม่เกิน 3 คน organizerCount <= 3 true
โอเปอเรเตอร์เชิงตรรกะ (and, or, not)
ไดรฟ์ที่แชร์ที่มีคำว่า "confidential" ในชื่อและมีสมาชิกตั้งแต่ 20 คนขึ้นไป name contains 'confidential' and memberCount >= 20 true
ไดรฟ์ที่แชร์ที่มีคำว่า "confidential" ในชื่อจากไดรฟ์ที่แชร์ทั้งหมดขององค์กร name contains 'confidential' and orgUnitId = 'C03az79cb' true
ไดรฟ์ที่แชร์ที่มีชื่อประกอบด้วย "Project" หรือ "Archive" name contains 'Project' or name contains 'Archive' true
ไดรฟ์ที่แชร์ที่ไม่มีคำว่า "Draft" ในชื่อ not name contains 'Draft' true
ไดรฟ์ที่แชร์ที่ไม่ได้เป็นของหน่วยขององค์กรเป้าหมายและสร้างขึ้นหลังจากวันที่ที่ระบุ orgUnitId != 'C03az79cb' and createdTime > '2023-01-01T00:00:00' true

ค้นหาหลายคำด้วยวงเล็บ

คุณสามารถใช้วงเล็บเพื่อจัดกลุ่มข้อความค้นหาหลายรายการเข้าด้วยกัน ตัวอย่างเช่น หากต้องการค้นหาไดรฟ์ที่แชร์ที่สร้างขึ้นหลังจากวันที่ที่ระบุและมีผู้จัดมากกว่า 5 คนหรือมีสมาชิกมากกว่า 20 คน ให้ใช้การค้นหาต่อไปนี้

createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or memberCount > 20)

การค้นหานี้จะแสดงไดรฟ์ที่แชร์ทั้งหมดที่สร้างขึ้นหลังจากวันที่ 1 มกราคม 2019 และมีผู้จัดมากกว่า 5 คนหรือมีสมาชิกมากกว่า 20 คน

Drive API จะประเมินโอเปอเรเตอร์ and และ or จากซ้ายไปขวา ดังนั้นการค้นหาเดียวกันโดยไม่มีวงเล็บจะแสดงผลดังนี้

  • เฉพาะไดรฟ์ที่แชร์ที่มีผู้จัดมากกว่า 5 คนที่สร้างขึ้นหลังจากวันที่ 1 มกราคม 2019
  • ไดรฟ์ที่แชร์ทั้งหมดที่มีสมาชิกมากกว่า 20 คน แม้แต่ไดรฟ์ที่สร้างขึ้นก่อนวันที่ 1 มกราคม 2019