API Google Drive hỗ trợ một số cách để tìm kiếm tệp và thư mục.
Bạn có thể sử dụng phương thức files.list
để trả về tất cả hoặc 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 đối với 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 Drive của tôi của người dùng hiện tại
Sử dụng phương thức files.list
mà không cần tham số nào để trả về tất cả các tệp và thư mục.
GET https://www.googleapis.com/drive/v3/files
Tìm các tệp hoặc thư mục cụ thể trên Drive của tôi của người dùng hiện tại
Để tìm kiếm một tập hợp tệp hoặc thư mục cụ thể, hãy sử dụng trường chuỗi truy vấn q
bằng phương thức 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.
Chuỗi truy vấn chứa 3 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ừ 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ừ truy vấn và toán tử mà bạn có thể sử dụng tệp và thư mục lọc, hãy xem phần Cụm từ và toán tử truy vấn 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 bằng cách đặt loại MIME:
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 hỗ trợ trên Google Workspace và Google Drive.
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. 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ụ: |
---|---|
Tệp có tên "xin chào" | name = 'hello' |
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 tệp chứa văn bản "quan trọng" và nằm trong thùng rác | fullText contains 'important' and trashed = true |
Các tệp chứa từ "hello" | fullText contains 'hello' |
Các tệp không có từ "hello" | 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ó cụm từ tìm kiếm chứa ký tự "\" (ví dụ: "\authors") | fullText contains '\\authors' |
Tệp là thư mục | mimeType = 'application/vnd.google-apps.folder' |
Tệp không phải thư mục | mimeType != 'application/vnd.google-apps.folder' |
Tệp được sửa đổi sau một ngày cụ thể (múi giờ mặc định là UTC) | modifiedTime > '2012-06-04T12:00:00' |
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ệp được gắn dấu sao | starred = true |
Các tệp trong một bộ sưu tập (ví dụ: mã nhận dạng thư mục trong 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 tập hợp | 'appDataFolder' in parents |
Các tệp mà người dùng "test@example.org" là chủ sở hữu | 'test@example.org' in owners |
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 |
Các tệp được chia sẻ với người dùng được uỷ quyền có chứa từ "hello" trong tên | sharedWithMe and name contains 'hello' |
Các tệp có thuộc tính tệp tuỳ chỉnh hiển thị cho tất cả ứng dụng | properties has { key='mass' and value='1.3kg' } |
Các tệp có thuộc tính tệp tuỳ chỉnh riêng tư đối với ứng dụng yêu cầu | appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' } |
Tệp chưa được chia sẻ với bất kỳ ai hoặc miền nào (chỉ ở chế độ riêng tư hoặc được chia sẻ với một số người dùng hoặc nhóm cụ thể) | visibility = 'limited' |
Lọc kết quả tìm kiếm bằng thư viện ứng dụng
Mã mẫu sau đây cho biết cách sử dụng thư viện ứng dụng để lọc kết quả tìm kiếm theo tên tệp và mã nhận dạng của tệp JPEG. Mẫu này sử dụng cụm từ tìm kiếm mimeType
để thu hẹp kết quả thành các tệp thuộc loại image/jpeg
. Thao tác này cũng đặt spaces
thành drive
để thu hẹp hơn nữa phạm vi tìm kiếm trong Bộ nhớ Drive. Khi nextPageToken
trả về null
, sẽ không có kết quả nào khác.
Java
Python
Node.js
PHP
Tìm 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 properties
hoặc appProperties
có khoá và giá trị. Ví dụ: để tìm một thuộc tính tệp tuỳ chỉnh ở chế độ riêng tư cho ứng dụng yêu cầu có tên là additionalID
với giá trị là 8e8aceg2af2ge72e78
:
appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' }
Để biết thêm thông tin, 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 cụ thể. Ví dụ: 'labels/LABEL_ID' in
labels
. Nếu thành công, nội dung phản hồi sẽ chứa tất cả các thực thể tệp mà nhãn được áp dụng.
Cách tìm kiếm 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ị trường cụ thể. 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 bài viết 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 gọi files.list
sử dụng corpora
của user
. Để tìm kiếm các tập hợp từ vựng khác, chẳng hạn như các tệp được chia sẻ với domain
, hãy đặt tham số corpora
.
Bạn có thể tìm kiếm nhiều tập hợp từ vựng trong một truy vấn, mặc dù kết quả chưa hoàn chỉnh có thể được trả về nếu tập hợp từ vựng kết hợp quá lớn. Nếu incompleteSearch
là true
trong phần nội dung phản hồi, thì tất cả tài liệu đều không được trả về. Nếu điều này xảy ra, bạn nên thu hẹp truy vấn bằng cách chọn một tập hợp khác, chẳng hạn như user
hoặc drive
.
Chủ đề có liên quan
- Tìm bộ nhớ dùng chung
- Cụm từ tìm kiếm và toán tử
- Các loại MIME được Google Workspace và Google Drive hỗ trợ
- Vai trò và quyền
- Tìm tệp có nhãn hoặc giá trị trường cụ thể