Method: approvals.start

Bắt đầu quy trình Phê duyệt cho một tệp.

Yêu cầu HTTP

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

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 mà yêu cầu phê duyệt sẽ được tạo.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "reviewerEmails": [
    string
  ],
  "dueTime": string,
  "lockFile": boolean,
  "message": string
}
Trường
reviewerEmails[]

string

Bắt buộc. Email của những người dùng được chỉ định xem xét yêu cầu phê duyệt.
dueTime

string (Timestamp format)

Không bắt buộc. Thời gian đến hạn phê duyệt.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
lockFile

boolean

Không bắt buộc. Xác định xem có khoá tệp khi bắt đầu quy trình Phê duyệt hay không.
message

string

Không bắt buộc. Thông báo gửi cho người đánh giá khi thông báo cho họ về Yêu cầu phê duyệt.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể của Approval.

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.file
  • https://www.googleapis.com/auth/drive.metadata

Một số phạm vi bị hạn chế và yêu cầu bạn phải đá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.