Để 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.
Một chuỗi truy vấn gồm ba phần sau:
query_term operator values
Trong trường hợp:
query_term
là từ khoá hoặc trường để 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.
Để xem các cụm từ truy vấn và toán tử mà bạn có thể dùng để lọc bộ nhớ dùng chung, hãy xem phần Cụm từ tìm kiếm và toán tử cho cụm 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ế còn tuỳ thuộc vào thư viện ứng dụng mà bạn 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à ký tự dấu gạch chéo ngược ("\"
), hãy sử dụng dấu gạch chéo ngược để thoát chúng: 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 hiển thị ở 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ừ "bảo 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ừ "bảo mật" trong tiêu đề giữa tất cả cá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ừ "bảo mật" trong tiêu đề giữa tất cả cá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 chưa được chỉ định người tổ chức | 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ừ có dấu ngoặc đơn
Bạn có thể sử dụng dấu ngoặc đơn để nhóm nhiều cụm từ truy vấn 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 có hơn 20 thành viên, hãy sử dụng truy vấn sau:
createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or
memberCount > 20)
Thao tác tìm kiếm này trả về tất cả cá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 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 đó, thao tác tìm kiếm tương tự không có dấu ngoặc đơn sẽ trả về:
- Chỉ các bộ nhớ dùng chung với hơn 5 người tổ chức được tạo sau ngày 1/1/2019.
- Tất cả các bộ nhớ dùng chung có hơn 20 thành viên, ngay cả những thành viên được tạo trước ngày 1 tháng 1 năm 2019.