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 cụm từ và toán tử tìm kiếm mà bạn có thể sử dụng với Google Drive API để lọc tệp, thư mục và bộ nhớ dùng chung.

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

Để xem ví dụ về cách tìm kiếm bộ nhớ dùng chung, hãy xem phần Tìm kiếm bộ nhớ dùng chung.

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

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

query_term operator values

Trong trường hợp:

  • query_term là cụm từ hoặc trường truy vấn để tìm kiếm.

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

  • values là những 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 có trong chuỗi kia.
= Nội dung của một chuỗi hoặc boolean bằng với nội dung của chuỗi hoặc boolean khác.
!= Nội dung của một chuỗi hoặc boolean không bằng với nội dung của chuỗi hoặc boolean 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 Một phần tử nằm trong một bộ sưu tập.
and Trả về những mục khớp với cả hai truy vấn.
or Trả về các mục khớp với một trong hai truy vấn.
not Phủ định một cụm từ tìm kiếm.
has Một tập hợp chứa một phần tử khớp với các thông số.

Cụm từ tìm kiếm dành riêng cho tệp

Bảng sau đây liệt kê tất cả các cụm từ tìm kiếm 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 về tài nguyên files.

Cụm từ tìm kiếm Toán tử hợp lệ Cách sử dụng
name contains, =, != Tên của tệp. Đặt trong dấu nháy đơn ('). Thoát dấu nháy đơn trong các truy vấn bằng \', chẳng hạn như 'Valentine\'s Day'.
fullText contains Cho dù các thuộc tính name, description, indexableText hay 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. Đặt trong dấu nháy đơn ('). Thoát dấu nháy đơn trong các 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 ('). Thoát dấu nháy đơn trong các 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ỉ có thể so sánh với ngày cố định.
viewedByMeTime <=, <, =, !=, >, >= Ngày mà người dùng xem một 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ỉ có thể so sánh với ngày cố định.
trashed =, != 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 các phần tử mẹ có chứa mã nhận dạng được 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ề 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ề tài nguyên 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 tệp. 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 tuỳ chỉnh công khai của tệp.
appProperties has Thuộc tính tuỳ chỉnh riêng của tệp.
visibility =, != Cấp độ hiển thị của tệp. Các giá trị hợp lệ là anyoneCanFind, anyoneWithLink, domainCanFind, domainWithLink và limited. Đặt trong dấu nháy đơn (').
shortcutDetails.targetId =, != Mã của mặt hàng 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ừ tìm kiếm:

  • Toán tử contains chỉ thực hiện so khớp tiền tố cho một cụm từ name. Ví dụ: giả sử bạn có một tên là HelloWorld. Truy vấn name contains 'Hello' trả về một 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 sẽ khớp với một cụm từ chữ và số chính xác nếu toán hạng bên phải đượ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ề một kết quả, nhưng truy vấn fullText contains '"Hello world"' thì không. Ngoài ra, 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 có 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à đề cập đến role đối với quyền. Để xem danh sách đầy đủ các quyền theo vai trò, hãy xem bài viết Vai trò và quyền.

Để xem thêm ví dụ về tìm kiếm bằng chuỗi truy vấn, hãy xem ví dụ về chuỗi truy vấn của 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ụm từ tìm kiếm 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 thông tin tham khảo về tài nguyên drives.

Cụm từ tìm kiếm 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 một giá trị bằng số. true
name contains, =, != Tên của bộ nhớ dùng chung. Đặt trong dấu nháy đơn ('). Thoát dấu nháy đơn trong các truy vấn bằng \', 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 một giá trị bằng số. true
orgUnitId =, != Mã nhận dạng đơn vị tổ chức của bộ nhớ dùng chung. Nhận một giá trị chuỗi. true

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