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ừ tìm kiếm 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 kiếm tệp, hãy xem bài viết Tìm tệp và thư mục.

Để xem các ví dụ về 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

Một chuỗi truy vấn gồm 3 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 sử 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 giá trị boolean bằng với chuỗi hoặc giá trị boolean kia.
`!=`	Nội dung của một chuỗi hoặc giá trị boolean không bằng với chuỗi hoặc giá trị boolean kia.
`<`	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ề các 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 truy vấn tìm kiếm.
`has`	Một bộ sưu tậ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 kiểu 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 biết liệu các thuộc tính `name`, `description`, `indexableText` hoặc văn bản trong nội dung của tệp hay 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 Các loại MIME được Google Workspace và Google Drive hỗ trợ.
`modifiedTime`	`<=`, `<`, `=`, `!=`, `>`, `>=`	Ngày sửa đổi 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`. Các trường thuộc kiểu `date` không thể so sánh với nhau, mà chỉ có thể so sánh với các ngày cố định.
`viewedByMeTime`	`<=`, `<`, `=`, `!=`, `>`, `>=`	Ngày mà người dùng xem 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`. Các trường thuộc kiểu `date` không thể so sánh với nhau, mà chỉ có thể so sánh với các ngày cố định.
`trashed`	`=`, `!=`	Cho biết tệp có nằm 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`	Cho biết bộ sưu tập cha 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. 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. 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 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 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 tệp tuỳ chỉnh công khai.
`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ục mà lối tắt trỏ đến.

Sau đây là 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 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 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 so khớp 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ì truy vấn 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 cụm từ 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. Để 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 các ví dụ về tìm kiếm chuỗi truy vấn, hãy xem các 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ừ tìm kiếm bộ nhớ dùng chung hợp lệ. Để biết các kiểu 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ị 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ị 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`

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