Thuật ngữ và toán tử của cụm từ tìm kiếm

Hướng dẫn tham khảo này cung cấp các thuật ngữ truy vấn và toán tử mà bạn có thể sử dụng với API Google Drive để lọc các tệp, thư mục và bộ nhớ dùng chung.

Để xem các ví dụ về tính năng tìm kiếm tệp, hãy xem phần Tìm kiếm tệp và thư mục.

Để xem ví dụ về nội dung tìm kiếm trong bộ nhớ dùng chung, hãy xem bài viết Tìm kiếm bộ nhớ dùng chung.

Cú pháp chuỗi truy vấn

Một chuỗi truy vấn gồm ba phần sau:

query_term operator values

Trong trường hợp:

  • query_term là từ khoá hoặc trường để tìm kiếm.

  • operator chỉ định điều kiện cho cụm từ truy vấn.

  • values là các giá trị cụ thể mà bạn muốn dùng để lọc kết quả tìm kiếm.

Toán tử truy vấn

Bảng sau đây liệt kê các toán tử truy vấn hợp lệ:

Đơn vị tổ chức Cách sử dụng
contains Nội dung của một chuỗi sẽ hiện diện trong chuỗi còn lại.
= Nội dung của một chuỗi hoặc boolean sẽ bằng với nội dung khác.
!= Nội dung của một chuỗi hoặc boolean không bằng nội dung khác.
< Một giá trị nhỏ hơn một giá trị khác.
<= Một giá trị nhỏ hơn hoặc bằng một giá trị khác.
> Một giá trị lớn hơn một giá trị khác.
>= Một giá trị lớn hơn hoặc bằng một giá trị khác.
in Phần tử nằm trong một tập hợp.
and Trả về những mục khớp với cả hai cụm từ tìm kiếm.
or Trả về các mục khớp với một trong hai truy vấn.
not Phủ định cụm từ tìm kiếm.
has Tập hợp chứa một phần tử khớp với các tham số.

Cụm từ truy vấn theo tệp cụ thể

Bảng sau liệt kê tất cả các thuật ngữ truy vấn tệp hợp lệ. Đối với các loại dữ liệu và nội dung mô tả, hãy tham khảo tài nguyên tham khảo files.

Cụm từ truy vấn Toán tử hợp lệ Cách sử dụng
name contains, =, != Tên tệp. Bao quanh bằng dấu nháy đơn ('). Thoát khỏi dấu ngoặc đơn trong truy vấn bằng \', chẳng hạn như 'Valentine\'s Day'.
fullText contains Liệu thuộc tính name, description, indexableText hoặc văn bản trong nội dung hoặc siêu dữ liệu của tệp có khớp với nhau hay không. Bao quanh bằng dấu nháy đơn ('). Thoát khỏi dấu ngoặc đơn trong truy vấn bằng \', chẳng hạn như 'Valentine\'s Day'.
mimeType contains, =, != Loại MIME của tệp. Bao quanh bằng dấu nháy đơn ('). Thoát khỏi dấu ngoặc đơn trong truy vấn bằng \', chẳng hạn như 'Valentine\'s Day'. Để biết thêm thông tin về các loại MIME, hãy xem bài viết Các loại MIME được Google Workspace và Google Drive hỗ trợ.
modifiedTime <=, <, =, !=, >, >= Ngày sửa đổi tệp gần đây nhất. Định dạng RFC 3339, múi giờ mặc định là UTC, chẳng hạn như 2012-06-04T12:00:00-08:00. Các trường thuộc loại date không thể so sánh với nhau mà chỉ so sánh với ngày không đổi.
viewedByMeTime <=, <, =, !=, >, >= Ngày mà người dùng xem tệp gần đây nhất. Định dạng RFC 3339, múi giờ mặc định là UTC, chẳng hạn như 2012-06-04T12:00:00-08:00. Các trường thuộc loại date không thể so sánh với nhau mà chỉ so sánh với ngày không đổi.
trashed =, != Liệu tệp có nằm trong thùng rác hay không. Có thể là true hoặc false.
starred =, != Liệu tệp có được gắn dấu sao hay không. Có thể là true hoặc false.
parents in Liệu tập hợp mẹ có chứa mã nhận dạng đã chỉ định hay không.
owners in Người dùng sở hữu tệp.
writers in Người dùng hoặc nhóm có quyền sửa đổi tệp. Hãy xem tài liệu tham khảo về permissions.
readers in Người dùng hoặc nhóm có quyền đọc tệp. Hãy xem tài liệu tham khảo về permissions.
sharedWithMe =, != Các tệp nằm trong bộ sưu tập "Được chia sẻ với tôi" của người dùng. Tất cả người dùng tệp đều nằm trong Danh sách kiểm soát quyền truy cập (ACL) của tệp. Có thể là true hoặc false.
createdTime <=, <, =, !=, >, >= Ngày tạo bộ nhớ dùng chung. Sử dụng định dạng RFC 3339, múi giờ mặc định là UTC, chẳng hạn như 2012-06-04T12:00:00-08:00.
properties has Thuộc tính tệp tuỳ chỉnh công khai.
appProperties has Thuộc tính tệp tuỳ chỉnh riêng tư.
visibility =, != Mức độ hiển thị của tệp. Các giá trị hợp lệ là anyoneCanFind, anyoneWithLink, domainCanFind, domainWithLink và limited. Bao quanh bằng dấu nháy đơn (').
shortcutDetails.targetId =, != Mã của mục mà lối tắt trỏ đến.

Dưới đây minh hoạ các tổ hợp toán tử và thuật ngữ truy vấn:

  • Toán tử contains chỉ thực hiện việc so khớp tiền tố cho một cụm từ name. Ví dụ: giả sử bạn có tên là HelloWorld. Truy vấn name contains 'Hello' trả về kết quả, nhưng truy vấn name contains 'World' thì không.

  • Toán tử contains chỉ thực hiện việc so khớp trên toàn bộ mã thông báo chuỗi cho cụm từ fullText. Ví dụ: nếu văn bản đầy đủ của tài liệu chứa chuỗi "HelloWorld", thì chỉ truy vấn fullText contains 'HelloWorld' mới trả về kết quả.

  • Toán tử contains khớp với một cụm từ chính xác bao gồm chữ và số nếu cụm từ đó được đặt trong dấu ngoặc kép. Ví dụ: nếu fullText của một tài liệu chứa chuỗi "Xin chào thế giới", thì truy vấn fullText contains '"Hello there"' sẽ trả về một kết quả, nhưng truy vấn fullText contains '"Hello world"' thì không. Hơn nữa, vì nội dung tìm kiếm có dạng chữ và số, nên nếu văn bản đầy đủ của tài liệu chứa chuỗi "Hello_world", thì truy vấn fullText contains '"Hello world"' sẽ trả về một kết quả.

  • Các điều khoản owners, writers và readers được phản ánh gián tiếp trong danh sách permissions và tham chiếu đến role trong quyền. Để xem danh sách đầy đủ các quyền theo vai trò, hãy xem phần Vai trò và quyền.

Để biết thêm ví dụ về tìm kiếm chuỗi truy vấn, hãy xem ví dụ về chuỗi truy vấn tệp.

Các cụm từ truy vấn dành riêng cho bộ nhớ dùng chung

Bảng sau đây liệt kê tất cả các cụm từ truy vấn hợp lệ cho bộ nhớ dùng chung. Để biết các loại dữ liệu và nội dung mô tả, hãy xem tài liệu tham khảo về tài nguyên drives.

Cụm từ truy vấn Toán tử hợp lệ Cách sử dụng Chế độ cài đặt useDomainAdminAccess
createdTime <=, <, =, !=, >, >= Ngày tạo bộ nhớ dùng chung. Định dạng RFC 3339, múi giờ mặc định là UTC, chẳng hạn như 2012-06-04T12:00:00-08:00. true
hidden =, != Chỉ định xem bộ nhớ dùng chung có bị ẩn hay không. Có thể là true hoặc false. false
memberCount <=, <, =, !=, >, >= Số người dùng và nhóm là thành viên của bộ nhớ dùng chung. Nhận một giá trị số. true
name contains, =, != Tên của bộ nhớ dùng chung. Bao quanh bằng dấu nháy đơn ('). Thoát khỏi dấu ngoặc đơn trong truy vấn bằng \', chẳng hạn như 'Valentine\'s Day'. true
organizerCount <=, <, =, !=, >, >= Số người dùng và nhóm là người tổ chức của bộ nhớ dùng chung. Nhận một giá trị số. true
orgUnitId =, != Mã đơn vị tổ chức của bộ nhớ dùng chung. Nhận một giá trị chuỗi. true

Để biết thêm ví dụ về tìm kiếm chuỗi truy vấn, hãy xem ví dụ về chuỗi truy vấn bộ nhớ dùng chung.