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ừ truy vấn và toán tử 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.

Để xem các ví dụ về tìm tệp, hãy xem bài viết Tìm tệp và thư mục.

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

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

Chuỗi truy vấn chứa ba phần sau:

query_term operator values

Trong trường hợp:

  • query_term là trường hoặc cụm từ truy vấn để 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ẽ xuất hiện trong chuỗi khác.
= Nội dung của một chuỗi hoặc boolean 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 với nội dung khác.
< Một giá trị thấp 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ề các mục khớp với cả hai truy vấn.
or Trả về các mặt hàng khớp với một trong hai truy vấn.
not Phủ định cụm từ tìm kiếm.
has Bộ sưu tậ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ả thuật ngữ 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 nguyên tham chiếu đến 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. Bao quanh bằng dấu ngoặc đơn ('). Thoát 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 không. Bao quanh bằng dấu ngoặc đơn ('). Thoát 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 ngoặc đơn ('). Thoát 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, chỉ có 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, chỉ có ngày không đổi.
trashed =, != Liệu tệp có trong thùng rác hay không. Có thể là true hoặc false.
starred =, != Cho biết tệp có được gắn dấu sao hay không. Có thể là true hoặc false.
parents in Liệu bộ sưu tập gốc 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 =, != 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. Hãy 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.

Phần sau đây 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 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' sẽ trả về kết quả, nhưng truy vấn name contains 'World' thì không trả về kết quả.

  • 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 của thuật ngữ fullText. Ví dụ: nếu toàn bộ văn bản của tài liệu chứa chuỗi "HelloWorld", thì chỉ truy vấn fullText contains 'HelloWorld' trả về kết quả.

  • Toán tử contains khớp với cụm từ chính xác gồm chữ và số nếu nằm trong dấu ngoặc kép. Ví dụ: nếu fullText của tài liệu chứa cụm từ "Xin chào mọi người", thì truy vấn fullText contains '"Hello there"' sẽ trả về kết quả, còn 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 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ề 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 trên quyền. Để biết 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ụ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ừ truy vấn bộ nhớ dùng chung hợp lệ. Để 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ừ 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 có ẩn bộ nhớ dùng chung 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 ngoặc đơn ('). Thoát 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 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ề hoạt động 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.