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

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

Để biết 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.

Ví dụ: tìm kiếm trong bộ nhớ dùng chung, hãy xem bài viết Tìm kiếm trong 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à cụm từ tìm kiếm hoặc trường để tìm kiếm.

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

  • 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 xuất hiệ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 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 giá trị khác.
>= Một giá trị lớn hơn hoặc bằng một giá trị khác.
in Một phần tử nằm trong một bộ sưu tập.
and Trả về các 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 cụm từ tìm kiếm.
not Bỏ qua một 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 đây liệt kê tất cả các cụm từ truy vấn tệp hợp lệ. Để biết các loại dữ liệu và nội dung mô tả, hãy tham khảo tài liệu tham khảo tài nguyên files.

Cụm từ truy vấn Toán tử hợp lệ Cách sử dụng
name contains, =, != Tên tệp. Đặt trong dấu nháy đơn ('). Dùng \' để thoát dấu nháy đơn trong truy vấn, 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 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. Đặt trong dấu nháy đơn ('). Dùng \' để thoát dấu nháy đơn trong truy vấn, 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 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, chỉ có thể so sánh với các 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 =, != Tệp có được gắn dấu sao hay không. Có thể là true hoặc false.
parents in Tập hợp mẹ có chứa mã nhận dạng được chỉ định hay không.
owners in Những 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. Xem tài liệu tham khảo tài nguyên 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 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 có 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.
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.

Sau đây là ví dụ minh hoạ các tổ hợp toán tử và cụm từ 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 toàn bộ văn bản của một 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ừ gồm chữ và số chính xác 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 "Hello there world", thì truy vấn fullText contains '"Hello there"' sẽ trả về 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 là chữ và số, nên nếu toàn bộ văn bản của một 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ề nội dung tìm kiếm bằng chuỗi truy vấn, hãy xem ví dụ về chuỗi truy vấn tệp.

Cụm từ tìm kiếm 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 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ố lượng người dùng và nhóm là thành viên của bộ nhớ dùng chung. Nhận giá trị số. true
name contains, =, != Tên của bộ nhớ dùng chung. Đặt trong dấu nháy đơn ('). Dùng \' để thoát dấu nháy đơn trong truy vấn, chẳng hạn như 'Valentine\'s Day'. true
organizerCount <=, <, =, !=, >, >= Số lượng người dùng và nhóm là người tổ chức của bộ nhớ dùng chung. Nhận giá trị số. true
orgUnitId =, != Mã nhận dạng đơn vị tổ chức của một 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.