Tìm bộ nhớ dùng chung

Hướng dẫn này giải thích cách API Google Drive hỗ trợ một số cách tìm kiếm ổ đĩa dùng chung.

Để 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 bằng phương thức list trên tài nguyên drives để 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.

Ví dụ: chuỗi truy vấn sau đây sẽ lọc kết quả tìm kiếm để chỉ trả về những bộ nhớ dùng chung có tên "Tài nguyên API Google Drive".

q: name = 'Google Drive API resources' & useDomainAdminAccess=false

Để xem tất cả cụm từ tìm kiếm của bộ nhớ dùng chung, hãy xem phần Cụm từ tìm kiếm dành riêng cho bộ nhớ dùng chung.

Để xem tất cả các toán tử truy vấn mà bạn có thể dùng để tạo truy vấn, hãy xem Toán tử truy vấn.

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 cần truy vấn Ví dụ Chế độ cài đặt useDomainAdminAccess
Toán tử so khớp chuỗi (contains)
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
Toán tử bằng và không bằng (=, !=)
Bộ nhớ dùng chung xuất hiện trong chế độ xem mặc định hidden = false false
Bộ nhớ dùng chung bị ẩn khỏi chế độ xem mặc định hidden = true 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 chỉ có một thành viên memberCount = 1 true
Bộ nhớ dùng chung thuộc mã đơn vị tổ chức orgUnitId = 'C03az79cb' true
Bộ nhớ dùng chung không chứa mã đơn vị tổ chức orgUnitId != 'C03az79cb' true
Bộ nhớ dùng chung có tên không khớp với một tên cụ thể name != 'Archived Projects' true
Toán tử so sánh (>, >=, <, <=)
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 được tạo trước ngày 1 tháng 1 năm 2023 createdTime < '2023-01-01T00:00:00' true
Bộ nhớ dùng chung có nhiều thành viên memberCount > 1 true
Bộ nhớ dùng chung có ít hơn 5 thành viên memberCount < 5 true
Bộ nhớ dùng chung có từ 3 người tổ chức trở xuống organizerCount <= 3 true
Toán tử logic (and, or, not)
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ên chứa từ "Dự án" hoặc "Lưu trữ" name contains 'Project' or name contains 'Archive' true
Bộ nhớ dùng chung không có từ "Bản nháp" trong tên not name contains 'Draft' true
Bộ nhớ dùng chung không thuộc một đơn vị tổ chức mục tiêu và được tạo sau một ngày cụ thể orgUnitId != 'C03az79cb' and createdTime > '2023-01-01T00:00:00' true

Tìm kiếm 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.

API Drive đá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.