Để tìm một nhóm 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 các bộ nhớ dùng chung 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 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 để tìm kiếm.operator
chỉ định điều kiện cho cụm từ tìm kiếm.values
là những 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ừ 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 lọc nội dung tìm kiếm để chỉ trả về những ổ đĩa dùng chung có tên "Google Drive API resources" (Tài nguyên Google Drive API).
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 ổ đĩa 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 cho cụm từ 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 dùng dấu gạch chéo ngược để thoát 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ừ "bí 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í 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ừ "bí 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ể 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 bộ nhớ dùng chung được tạo sau một ngày cụ thể và có hơn 5 người tổ chức hoặc 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)
Lệnh 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ó hơn 5 người tổ chức hoặc hơn 20 thành viên.
Drive API đánh giá các toán tử and
và or
từ trái sang phải, vì vậy, cùng một cụm từ tìm kiếm nhưng không có dấu ngoặc đơn sẽ trả về:
- Chỉ những bộ nhớ dùng chung có hơn 5 người tổ chức và đượ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, kể cả những bộ nhớ dùng chung được tạo trước ngày 1 tháng 1 năm 2019.