Liệt kê bộ nhớ dùng chung của người dùng.
Phương thức này chấp nhận tham số q
. Đây 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 bộ nhớ dùng chung.
Yêu cầu HTTP
GET https://www.googleapis.com/drive/v3/drives
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số truy vấn
Tham số | |
---|---|
pageSize |
Số bộ nhớ dùng chung tối đa cần trả về trên mỗi trang. |
pageToken |
Mã thông báo trang cho bộ nhớ dùng chung. |
q |
Chuỗi truy vấn để tìm kiếm bộ nhớ dùng chung. |
useDomainAdminAccess |
Gửi yêu cầu với tư cách là quản trị viên miền; nếu bạn đặt chính sách này thành true, thì tất cả bộ nhớ dùng chung của miền mà người yêu cầu là quản trị viên sẽ được trả về. |
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 bộ nhớ dùng chung.
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,
"drives": [
{
object ( |
Trường | |
---|---|
nextPageToken |
Mã thông báo trang cho trang tiếp theo của bộ nhớ dùng chung. Giá trị này sẽ không hiển thị nếu đã đến cuối danh sách. Nếu mã thông báo bị từ chối vì bất kỳ lý do gì, thì bạn nên loại bỏ mã đó và bắt đầu lại quá trình phân trang từ trang kết quả đầu tiên. Mã thông báo của 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ả bạn mong đợi có thể sẽ khác. |
kind |
Xác định loại tài nguyên này. Giá trị: chuỗi cố định |
drives[] |
Danh sách bộ nhớ dùng chung. Nếu bạn điền mã nextPageToken, thì danh sách này có thể chưa hoàn chỉnh và hệ thống sẽ tìm nạp một trang kết quả khác. |
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.readonly
Một số phạm vi bị hạn chế và yêu cầu đánh giá bảo mật để ứng dụng của bạn có thể sử dụng các phạm vi đó. Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.