Sử dụng phương thức files.list
để trả về tất cả hoặc chỉ một số tệp và thư mục của người dùng Drive.
Bạn cũng có thể sử dụng phương thức files.list
để truy xuất fileId
cần thiết cho một số phương thức tài nguyên (chẳng hạn như files.get
và files.update
).
Tìm tất cả tệp và thư mục trên trang Drive của tôi của người dùng hiện tại
Sử dụng files.list
mà không có bất kỳ tham số nào để trả về tất cả tệp và thư mục.
Tìm kiếm các tệp hoặc thư mục cụ thể trên trang Drive của tôi của người dùng hiện tại
Để tìm kiếm một nhóm tệp hoặc thư mục cụ thể, hãy sử dụng trường q
của chuỗi truy vấn với files.list
để lọc các tệp 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 chứa ba phần sau:
query_term operator values
Trong trường hợp:
query_term
là cụm từ truy vấn hoặc trường để tìm kiếm. Để xem các cụm từ tìm kiếm có thể dùng để lọc bộ nhớ dùng chung, hãy tham khảo bài viết Toán tử và cụm từ tìm kiếm.operator
chỉ định điều kiện cho cụm từ truy vấn. Để xem bạn có thể sử dụng những toán tử nào với mỗi cụm từ truy vấn, hãy tham khảo phần Toán 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.
Ví dụ: chuỗi truy vấn sau đây lọc nội dung tìm kiếm để chỉ trả về các thư mục:
q: mimeType = 'application/vnd.google-apps.folder'
Ví dụ sau cho thấy cách dùng thư viện ứng dụng khách để lọc kết quả tìm kiếm theo tên và mã nhận dạng của các tệp JPEG. Ví dụ này sử dụng cụm từ truy vấn mimeType
để thu hẹp kết quả ở các tệp loại image/jpeg
. Ví dụ này cũng đặt spaces
thành drive
để thu hẹp thêm phạm vi tìm kiếm trong không gian Drive. Khi nextPageToken
trả về null
, không có kết quả nào khác.
Java
Python
Node.js
1.199
Để giới hạn phạm vi tìm kiếm trong các thư mục, hãy sử dụng chuỗi truy vấn để đặt loại MIME thành q: mimeType = 'application/vnd.google-apps.folder'
Để biết thêm thông tin về các loại MIME, hãy xem bài viết Các loại MIME được Google Workspace và Google Drive hỗ trợ.
Ví dụ về chuỗi truy vấn
Bảng này hiển thị một số chuỗi truy vấn cơ bản. Mã thực tế còn tuỳ thuộc vào thư viện ứng dụng bạn dùng cho nội dung tìm kiếm của mình.
Nội dung bạn muốn truy vấn | Ví dụ: |
---|---|
Tệp có tên "xin chào" | name = 'hello' |
Các tệp có tên chứa từ "xin chào" và "tạm biệt" | name contains 'hello' and name contains 'goodbye' |
Tệp có tên không chứa từ "hello" | not name contains 'hello' |
Các thư mục là các ứng dụng của Google hoặc có loại MIME của thư mục | mimeType = 'application/vnd.google-apps.folder' |
Tệp không phải là thư mục | mimeType != 'application/vnd.google-apps.folder' |
Tệp có chứa nội dung "quan trọng" và nằm trong thùng rác | fullText contains 'important' and trashed = true |
Tệp có chứa từ "hello" | fullText contains 'hello' |
Tệp không có từ "xin chào" | not fullText contains 'hello' |
Tệp có chứa chính xác cụm từ "xin chào thế giới" | fullText contains '"hello world"' |
Tệp có truy vấn chứa ký tự "\" (ví dụ: "\authors") | fullText contains '\\authors' |
Các tệp có mã nhận dạng trong một bộ sưu tập, ví dụ: bộ sưu tập parents |
'1234567' in parents |
Các tệp trong thư mục dữ liệu ứng dụng trong một bộ sưu tập | 'appDataFolder' in parents |
Các tệp mà người dùng "test@example.org" có quyền ghi | 'test@example.org' in writers |
Các tệp mà thành viên của nhóm "group@example.org" có quyền ghi | 'group@example.org' in writers |
Tệp được sửa đổi sau một ngày cụ thể | modifiedTime > '2012-06-04T12:00:00' // default time zone is UTC |
Tệp được chia sẻ với người dùng được uỷ quyền có tên chứa từ "hello" | sharedWithMe and name contains 'hello' |
Tệp chưa được chia sẻ với bất kỳ ai hoặc miền nào (chỉ riêng tư hoặc được chia sẻ với những người dùng hoặc nhóm cụ thể) | visibility = 'limited' |
Tệp hình ảnh hoặc video được sửa đổi sau một ngày cụ thể | modifiedTime > '2012-06-04T12:00:00' and (mimeType contains 'image/' or mimeType contains 'video/') |
Tìm các tệp có thuộc tính tệp tuỳ chỉnh
Để tìm kiếm các tệp có thuộc tính tệp tuỳ chỉnh, hãy sử dụng cụm từ tìm kiếm appProperties
kèm theo khoá và giá trị. Ví dụ: để tìm kiếm thuộc tính tệp tuỳ chỉnh có tên là additionalID
với giá trị 8e8aceg2af2ge72e78
:
appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' }
Để biết thêm thông tin về các thuộc tính tệp tuỳ chỉnh, hãy xem phần Thêm thuộc tính tệp tuỳ chỉnh.
Tìm tệp có nhãn hoặc giá trị trường cụ thể
Để tìm kiếm các tệp có nhãn cụ thể, hãy sử dụng cụm từ tìm kiếm labels
với mã nhận dạng nhãn cụ thể. Ví dụ: 'labels/LABEL_ID'
in labels
Cách tìm kiếm các tệp không có mã nhãn cụ thể: Not
'labels/LABEL_ID' in labels
Bạn cũng có thể tìm kiếm tệp dựa trên các giá trị cụ thể của trường. Ví dụ: để tìm kiếm các tệp có giá trị văn bản: labels/LABEL_ID.text_field_id =
'TEXT'
Để biết thêm thông tin, hãy xem phần Tìm tệp có nhãn hoặc giá trị trường cụ thể.
Tìm kiếm tập sao lục
Theo mặc định, các lượt tìm kiếm có lệnh gọi files.list
sẽ sử dụng kho dữ liệu user
. Để tìm kiếm các tập sao lục khác, chẳng hạn như các tệp được chia sẻ với miềnGoogle Workspace , hãy sử dụng tham số corpora
.
Có thể tìm kiếm nhiều tập sao lục trong một truy vấn, mặc dù có thể trả về kết quả không đầy đủ nếu tập sao kết hợp quá lớn. Nếu kết quả incompleteSearch
là true
, thì có nghĩa là hệ thống chưa trả về mọi tài liệu.