API Google Drive hỗ trợ một số cách để tì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. files.list
bạn cũng có thể sử dụng phương thức này để truy xuất fileId
cần thiết cho một số tài nguyên
(chẳng hạn như files.get
và
files.update
).
Tìm kiếm tất cả các tệp và thư mục trên phầ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
không có bất kỳ tham số nào để trả về tất cả các tệp và
.
GET https://www.googleapis.com/drive/v3/files
Tìm kiếm các tệp hoặc thư mục cụ thể trong phầ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 pháp files.list
để lọc
tệp cần trả lại 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 kết quả.
Để 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ừ tìm kiếm và toán tử.
Ví dụ: chuỗi truy vấn sau đây lọc 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 Google Workspace và Google Drive các loại MIME được hỗ trợ.
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ế 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à dấu gạch chéo ngược ("\"
), 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ụ: |
---|---|
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ừ "xin chào" | not name contains 'hello' |
Tệp có chứa văn bản "quan trọng" và trong thùng rác | fullText contains 'important' and trashed = true |
Tệp có chứa từ "xin chào" | 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' |
Tệp là 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 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ã 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 bộ sưu tập | 'appDataFolder' in parents |
Các tệp cho người dùng "test@example.org" là chủ sở hữu | 'test@example.org' in owners |
Các tệp cho người dùng "test@example.org" có quyền ghi | 'test@example.org' in writers |
Các tệp của thành viên trong nhóm "group@example.org" có quyền ghi | 'group@example.org' in writers |
Tệp được chia sẻ với người dùng được uỷ quyền có chứa lời chào "hello" trong tên | sharedWithMe and name contains 'hello' |
Các tệp có thuộc tính tệp tùy chỉnh hiển thị với tất cả ứng dụng | properties has { key='mass' and value='1.3kg' } |
Tệp có thuộc tính tệp tuỳ chỉnh là riêng tư đối với ứng dụng yêu cầu | appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' } |
Các 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' |
Lọc kết quả tìm kiếm bằng một 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
kết quả đối với tên tệp và mã nhận dạng của tệp JPEG. Mẫu này sử dụng mimeType
cụm từ truy vấn để thu hẹp kết quả vào các tệp loại image/jpeg
. Quy tắc này cũng đặt
spaces
đến drive
để thu hẹp thêm phạm vi tìm kiếm vào Drive
không gian. Khi nextPageToken
trả về null
,
không còn kết quả nào nữa.
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 properties
hoặc
cụm từ truy vấn tìm kiếm appProperties
có khoá và giá trị. Ví dụ: để
tìm kiếm thuộc tính tệp tuỳ chỉnh dành riêng cho ứng dụng yêu cầu có tên là
additionalID
với giá trị 8e8aceg2af2ge72e78
:
appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' }
Để biết thêm thông tin, hãy xem bài viết Thêm tệp tuỳ chỉnh thuộc tính.
Tìm tệp có nhãn hoặc giá trị trường cụ thể
Để tìm tệp có nhãn cụ thể, hãy dùng cụm từ tìm kiếm labels
bằng mã nhận dạng 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 phiên bản tệp mà
đã áp dụng nhãn.
Cách tìm tệp mà không có mã nhãn cụ thể: Not
'labels/LABEL_ID' in labels
.
Bạn cũng có thể tìm tệp dựa trên các giá trị cụ thể của trường. Ví dụ: để
tìm kiếm 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 kiếm tệp có nhãn hoặc trường cụ thể giá trị.
Tìm kiếm tập sao lục
Các lượt tìm kiếm gọi files.list
sử dụng
corpora
trong số user
theo mặc định. Để 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 domain
, hãy đặt corpora
.
Có thể tìm kiếm nhiều tập sao lục trong một truy vấn, mặc dù kết quả không hoàn chỉnh
có thể được trả về nếu tập sao lục kết hợp quá lớn. Nếu incompleteSearch
là
true
trong nội dung phản hồi thì tất cả tài liệu chưa được trả về. Nếu trường hợp này
xảy ra, bạn nên thu hẹp truy vấn của mình bằng cách chọn một tập sao lục 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ể