REST Resource: approvals

Tài nguyên: Approval

Siêu dữ liệu cho một yêu cầu phê duyệt. Phê duyệt là một quy trình xem xét hoặc phê duyệt cho một mục trên Drive.

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "approvalId": string,
  "targetFileId": string,
  "createTime": string,
  "modifyTime": string,
  "completeTime": string,
  "dueTime": string,
  "status": enum (Status),
  "initiator": {
    object (User)
  },
  "reviewerResponses": [
    {
      object (ReviewerResponse)
    }
  ],
  "fileContentChangeBehavior": enum (FileContentChangeBehavior)
}
Trường
kind

string

Giá trị này luôn là drive#approval.
approvalId

string

Mã phê duyệt.
targetFileId

string

Mã tệp mục tiêu của yêu cầu phê duyệt.
createTime

string (Timestamp format)

Thời gian tạo yêu cầu 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".
modifyTime

string (Timestamp format)

Thời gian gần đây nhất mà quyết định phê duyệt được sửa đổi.

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".
completeTime

string (Timestamp format)

Thời điểm hoàn tất quy trình 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".
dueTime

string (Timestamp format)

Thời 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".
status

enum (Status)

Trạng thái phê duyệt tại thời điểm yêu cầu tài nguyên này.
initiator

object (User)

Người dùng đã yêu cầu phê duyệt.
reviewerResponses[]

object (ReviewerResponse)

Câu trả lời của người đánh giá về yêu cầu phê duyệt.
fileContentChangeBehavior

enum (FileContentChangeBehavior)

Hành vi của quy trình phê duyệt khi nội dung tệp thay đổi.

Trạng thái

Các trạng thái có thể có của một yêu cầu phê duyệt.

Enum
STATUS_UNSPECIFIED Trạng thái phê duyệt chưa được đặt hoặc đã được đặt thành một giá trị không hợp lệ.
IN_PROGRESS Quá trình phê duyệt đã bắt đầu nhưng chưa hoàn tất.
APPROVED Quá trình phê duyệt đã hoàn tất và mục tiêu đã được phê duyệt.
CANCELLED Quy trình phê duyệt đã bị huỷ trước khi hoàn tất.
DECLINED Quá trình phê duyệt đã hoàn tất và mục tiêu đã bị từ chối.

ReviewerResponse

Câu trả lời về một yêu cầu phê duyệt do một người đánh giá cụ thể đưa ra.

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "reviewer": {
    object (User)
  },
  "response": enum (Response)
}
Trường
kind

string

Giá trị này luôn là drive#reviewerResponse.
reviewer

object (User)

Người dùng chịu trách nhiệm về phản hồi này.
response

enum (Response)

Phản hồi của người đánh giá về yêu cầu phê duyệt.

Phản hồi

Các phản hồi có thể có cho một yêu cầu phê duyệt.

Enum
RESPONSE_UNSPECIFIED Câu trả lời được đặt thành một giá trị không nhận dạng được.
NO_RESPONSE Người đánh giá chưa phản hồi.
APPROVED Người đánh giá đã phê duyệt mục này.
DECLINED Người đánh giá đã từ chối mục này.

FileContentChangeBehavior

Hành vi của quy trình phê duyệt khi nội dung tệp thay đổi trong khi quy trình phê duyệt Status là IN_PROGRESS. Hành vi này sẽ không còn xảy ra sau khi quá trình phê duyệt hoàn tất.

Enum
FILE_CONTENT_CHANGE_BEHAVIOR_UNSPECIFIED Hành vi không được chỉ định.
RESET_APPROVAL Mọi ReviewerResponse có Response là APPROVED sẽ được đặt lại thành NO_DECISION khi nội dung tệp thay đổi trong khi quy trình phê duyệt có Status là IN_PROGRESS. Khi yêu cầu phê duyệt có Status là APPROVED và RESET_APPROVAL được chọn, tệp sẽ bị khoá.
NO_APPROVAL_ACTION Không có hành động nào được thực hiện khi nội dung tệp thay đổi.

Phương thức

approve

 Phê duyệt một yêu cầu phê duyệt.

cancel

 Huỷ phê duyệt.

comment

 Nhận xét về một yêu cầu phê duyệt.

decline

 Từ chối phê duyệt.

get

 Lấy một phê duyệt theo mã nhận dạng.

list

 Liệt kê các yêu cầu phê duyệt đối với một tệp.

reassign

 Chỉ định lại người đánh giá cho một yêu cầu phê duyệt.

start

 Bắt đầu quy trình phê duyệt tệp.