- 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/v3/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à "người dùng", "miền", "drive" và "allDrives". Ưu tiên "user" hoặc "drive" cho "allDrives" để tăng tính hiệu quả. Theo mặc định, tập sao lục được đặt thành 'người dùng'. Tuy nhiên, điều này có thể thay đổi tuỳ thuộc vào tập hợp bộ lọc thông qua tham số 'q'. |
corpus |
Không dùng nữa: Nguồn của các tệp cần liệt kê. Thay vào đó, hãy sử dụng "corpora". |
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 |
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à "createdTime", "folder", "ModifiedByMeTime", "ModifiedTime", "name", "name_natural", "quotaBytesUsage", "recency", "sharedWithMeTime", "starred" và "SeeByMeTime". Theo mặc định, mỗi phím sẽ sắp xếp theo thứ tự tăng dần, nhưng bạn có thể đảo ngược bằng công cụ sửa đổi "description". Ví dụ về cách sử dụng: ?orderBy=lặp |
pageSize |
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. |
pageToken |
Mã thông báo để tiếp tục yêu cầu danh sách trước đó trên trang tiếp theo. Bạn nên đặt giá trị này thành giá trị "nextPageToken" từ phản hồi trước. |
q |
Truy vấn để lọc kết quả tệp. Xem hướng dẫn "Tìm kiếm tệp và thư mục" để biết cú pháp được hỗ trợ. |
spaces |
Danh sách các dấu cách được phân tách bằng dấu phẩy để truy vấn trong tập sao lục. Các giá trị được hỗ trợ là "drive" và "appDataFolder". |
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ị "đã xuất bản". |
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,
"incompleteSearch": boolean,
"files": [
{
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. Mã thông báo trang thường có hiệu lực trong vài giờ. Tuy nhiên, nếu bạn thêm hoặc xoá các mục mới, kết quả dự kiến của bạn có thể sẽ khác. |
kind |
Xác định đây là loại tài nguyên. Giá trị: chuỗi cố định |
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. Đ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ả các tập. 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 tập sao lục khác, chẳng hạn như "người dùng" hoặc "ổ đĩa". |
files[] |
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/drive
https://www.googleapis.com/auth/drive.appdata
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 | |
---|---|
user |
Các tệp do người dùng sở hữu hoặc chia sẻ. |
domain |
Tệp được chia sẻ với miền của người dùng. |