Để tìm kiếm một tập hợp bộ nhớ dùng chung cụ thể, hãy sử dụng trường chuỗi truy vấn q
với drives.list
để lọc bộ nhớ cần trả về bằng cách kết hợp một hoặc nhiều cụm từ tìm kiếm.
Chuỗi truy vấn chứa 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.
Để xem các cụm từ tìm kiếm và toán tử mà bạn có thể dùng để lọc bộ nhớ dùng chung, hãy xem bài viết Cụm từ tìm kiếm và toán tử tìm kiếm.
Ví dụ: chuỗi truy vấn sau đây sẽ lọc kết quả tìm kiếm để chỉ trả về các bộ nhớ dùng chung có tên "Tài nguyên API Google Drive".
q: name = 'Google Drive API resources' & useDomainAdminAccess=false
Ví dụ về chuỗi truy vấn
Bảng sau đây liệt kê ví dụ về một số chuỗi truy vấn cơ bản cho bộ nhớ dùng chung. Mã thực tế sẽ khác nhau tuỳ thuộc vào thư viện ứng dụng mà bạn sử dụng để tìm kiếm.
Bạn cũng phải thoát các ký tự đặc biệt trong tên tệp để đảm bảo truy vấn hoạt động chính xác. Ví dụ: nếu tên tệp chứa cả dấu nháy đơn ('
) và dấu gạch chéo ngược ("\"
), hãy sử dụng dấu gạch chéo ngược để thoát khỏi các ký tự đó: name
contains 'quinn\'s paper\\essay'
.
Nội dung bạn muốn truy vấn | Ví dụ: | Chế độ cài đặt useDomainAdminAccess |
---|---|---|
Bộ nhớ dùng chung được tạo sau ngày 1 tháng 6 năm 2017 | createdTime > '2017-06-01T12:00:00' |
true |
Bộ nhớ dùng chung xuất hiện trong chế độ xem mặc định | hidden = false |
false |
Bộ nhớ dùng chung có nhiều thành viên | memberCount > 1 |
true |
Bộ nhớ dùng chung có từ "mật" trong tiêu đề và có từ 20 thành viên trở lên | name contains 'confidential' and memberCount >= 20 |
true |
Bộ nhớ dùng chung có từ "mật" trong tiêu đề trong số tất cả bộ nhớ dùng chung của tổ chức | name contains 'confidential' and orgUnitId = 'C03az79cb' |
true |
Bộ nhớ dùng chung có từ "mật" trong tiêu đề trong số tất cả bộ nhớ dùng chung mà người dùng là thành viên | name contains 'confidential' |
false |
Bộ nhớ dùng chung không có người tổ chức được chỉ định | organizerCount = 0 |
true |
Bộ nhớ dùng chung không chứa mã đơn vị tổ chức | orgUnitId != 'C03az79cb' |
true |
Truy vấn nhiều cụm từ bằng dấu ngoặc đơn
Bạn có thể sử dụng dấu ngoặc đơn để nhóm nhiều cụm từ tìm kiếm lại với nhau. Ví dụ: để tìm kiếm các bộ nhớ dùng chung được tạo sau một ngày cụ thể và có nhiều hơn 5 người tổ chức hoặc nhiều hơn 20 thành viên, hãy sử dụng cụm từ tìm kiếm sau:
createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or
memberCount > 20)
Tìm kiếm này sẽ trả về tất cả bộ nhớ dùng chung được tạo sau ngày 1 tháng 1 năm 2019 và có nhiều hơn 5 người tổ chức hoặc nhiều hơn 20 thành viên.
API Drive đánh giá các toán tử and
và or
từ trái sang phải, do đó, phép tìm kiếm tương tự không có dấu ngoặc đơn sẽ trả về:
- Chỉ những bộ nhớ dùng chung có nhiều hơn 5 người tổ chức được tạo sau ngày 1 tháng 1 năm 2019.
- Tất cả bộ nhớ dùng chung có hơn 20 thành viên, ngay cả những bộ nhớ dùng chung được tạo trước ngày 1 tháng 1 năm 2019.