- Yêu cầu HTTP
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- Khối liệu
- Hãy làm thử!
Liệt kê các tệp của người dùng.
Phương thức này chấp nhận thông số q
, là một cụm từ tìm kiếm kết hợp một hoặc nhiều cụm từ tìm kiếm. Để biết thêm thông tin, hãy xem hướng dẫn Tìm kiếm tệp và thư mục.
Yêu cầu HTTP
GET https://www.googleapis.com/drive/v2/files
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số truy vấn
Các tham số | |
---|---|
corpora |
Thân của các mục (tệp/tài liệu) áp dụng cụm từ tìm kiếm. Các nội dung được hỗ trợ là |
corpus |
Không dùng nữa: Phần nội dung (tệp/tài liệu) mà truy vấn áp dụng. Thay vào đó, hãy sử dụng |
driveId |
Mã của bộ nhớ dùng chung cần tìm kiếm. |
includeItemsFromAllDrives |
Có cần đưa cả các mục trên Drive của tôi và bộ nhớ dùng chung vào kết quả hay không. |
includeTeamDriveItems |
Không dùng nữa: Thay vào đó, hãy dùng |
maxResults |
Số lượng tệp tối đa cần trả về trên mỗi trang. Có thể một phần hoặc không có trang kết quả trống, thậm chí trước khi đến cuối danh sách tệp. |
orderBy |
Danh sách các khoá sắp xếp được phân tách bằng dấu phẩy. Các khoá hợp lệ là |
pageToken |
Mã thông báo trang cho các tệp. |
projection |
Ngừng sử dụng: Tham số này không có hàm. |
q |
Chuỗi truy vấn để tìm tệp. |
spaces |
Danh sách các dấu cách được phân tách bằng dấu phẩy mà bạn muốn truy vấn. Giá trị được hỗ trợ là |
supportsAllDrives |
Liệu ứng dụng yêu cầu có hỗ trợ cả Drive của tôi và bộ nhớ dùng chung hay không. |
supportsTeamDrives |
Không dùng nữa: Thay vào đó, hãy dùng |
teamDriveId |
Không dùng nữa: Thay vào đó, hãy dùng |
includePermissionsForView |
Chỉ định quyền của khung hiển thị bổ sung để đưa vào phản hồi. Chỉ hỗ trợ giá trị |
includeLabels |
Danh sách mã nhãn được phân tách bằng dấu phẩy để đưa vào phần |
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Danh sách tệp.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{
"nextPageToken": string,
"kind": string,
"etag": string,
"selfLink": string,
"incompleteSearch": boolean,
"nextLink": string,
"items": [
{
object ( |
Các trường | |
---|---|
nextPageToken |
Mã thông báo trang cho trang tiếp theo của tệp. Tệp này sẽ không xuất hiện nếu đến cuối danh sách tệp. Nếu bị từ chối vì bất kỳ lý do gì, mã thông báo sẽ bị loại bỏ và bạn nên bắt đầu lại quá trình phân trang từ trang kết quả đầu tiên. |
kind |
Giá trị này luôn là |
etag |
ETag của danh sách. |
selfLink |
Một đường liên kết quay lại danh sách này. |
incompleteSearch |
Quá trình tìm kiếm có hoàn tất hay không. Nếu đúng thì một số kết quả tìm kiếm có thể bị thiếu vì tất cả tài liệu chưa được tìm kiếm. Điều này có thể xảy ra khi tìm kiếm nhiều ổ đĩa với tập sao lục "allDrives" nhưng không thể tìm kiếm tất cả tập sao. Khi điều này xảy ra, khách hàng 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ư "default" hoặc "drive". |
nextLink |
Một đường liên kết đến trang tiếp theo của các tệp. |
items[] |
Danh sách tệp. Nếu nextPageToken được điền, thì danh sách này có thể chưa đầy đủ và bạn nên tìm nạp một trang kết quả bổ sung. |
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau:
https://www.googleapis.com/auth/docs
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.apps.readonly
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.photos.readonly
https://www.googleapis.com/auth/drive.readonly
Một số phạm vi bị hạn chế và cần phải được đánh giá bảo mật thì ứng dụng của bạn mới có thể sử dụng những phạm vi đó. Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.
Chính
Enum | |
---|---|
DEFAULT |
Các mục mà người dùng đã truy cập. |
DOMAIN |
Các mục được chia sẻ với miền của người dùng. |