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ử 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.

Để 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 cần 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 có trong chuỗi còn lại.
= Nội dung của một chuỗi hoặc boolean bằng với 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 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 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 tham 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 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 tệp 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 dấu nháy đơ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 dấu nháy đơ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ó thể so sánh với ngày không đổi.
viewedByMeTime <=, <, =, !=, >, >= Ngày mà người dùng xem một tệp lần gần 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. Bạn không thể so sánh các trường thuộc loại date với nhau, mà chỉ có thể so sánh với các 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 Liệu tập hợp parents có chứa mã nhận dạng được chỉ định hay không. Chỉ kiểm tra các thư mục mẹ trực tiếp; không khớp với các thư mục mẹ gián tiếp.
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. 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 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 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. Chỉ được hỗ trợ trong API Drive phiên bản 3.
properties has Thuộc tính công khai của tệp tuỳ chỉnh.
appProperties has Thuộc tính tệp tuỳ chỉnh riêng tư.
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ã nhận dạng của mặt hàng mà lối tắt trỏ đến.

Sau đây là ví dụ về cách kế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ó 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ỉ có cụm từ tìm kiếm fullText contains 'HelloWorld' trả về kết quả.

  • Toán tử contains khớp với một cụm từ 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ề kết quả, nhưng truy vấn fullText contains '"Hello world"' thì không.

    • Nếu toàn bộ văn bản của một tài liệu chứa chuỗi "Hello_world", thì cụm từ tìm kiếm fullText contains '"Hello world"' vẫn trả về kết quả vì dấu gạch dưới trong chuỗi tài liệu được coi là dấu cách.

  • 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 về quyền. Để xem danh sách đầy đủ các quyền của vai trò, hãy xem bài viết Vai trò và quyền.

Để xem 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ụm từ truy vấn hợp lệ về 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ừ 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ị dạ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ị dạ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ề nội dung tìm kiếm theo chuỗi truy vấn, hãy xem ví dụ về chuỗi truy vấn cho bộ nhớ dùng chung.