Method: approvals.list

Liệt kê các yêu cầu phê duyệt trên một tệp. Để biết thêm thông tin, hãy xem bài viết Quản lý yêu cầu phê duyệt.

Yêu cầu HTTP

GET https://www.googleapis.com/drive/v3/files/{fileId}/approvals

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
fileId

string

Bắt buộc. Mã của tệp có yêu cầu phê duyệt.

Tham số truy vấn

Tham số
pageSize

integer

Số lượng yêu cầu phê duyệt tối đa cần trả về. Khi không được đặt, hệ thống sẽ trả về tối đa 100 yêu cầu phê duyệt.
pageToken

string

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ị của nextPageToken từ phản hồi trước đó.

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

Phản hồi của yêu cầu danh sách yêu cầu phê duyệt.

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 
{
  "kind": string,
  "items": [
    {
      object (Approval)
    }
  ],
  "nextPageToken": string
}
Trường
kind

string

Giá trị này luôn là drive#approvalList
items[]

object (Approval)

Danh sách yêu cầu phê duyệt. Nếu nextPageToken được điền sẵn, thì danh sách này có thể chưa hoàn chỉnh và bạn nên tìm nạp thêm một trang kết quả.
nextPageToken

string

Mã thông báo trang cho trang yêu cầu phê duyệt tiếp theo. Mã này sẽ không có nếu bạn đã đến cuối danh sách yêu cầu phê duyệt. Nếu mã thông báo bị từ chối vì bất kỳ lý do nào, bạn nên huỷ mã thông báo đó và khởi động lại việc phân trang từ trang kết quả đầu tiên.

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.readonly

Một số phạm vi bị hạn chế và yêu cầu ứng dụng của bạn phải được đánh giá bảo mật để 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.