REST Resource: approvals

Tài nguyên: Approval

Siêu dữ liệu cho một yêu cầu phê duyệt. Yêu cầu phê duyệt là quy trình xem xét hoặc phê duyệt 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

Đâ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)

Chỉ có đầu ra. Thời điểm 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)

Chỉ có đầu ra. Thời gian gần đây nhất mà yêu cầu 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)

Chỉ có đầu ra. Thời gian hoàn tất việc 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 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".
status

enum (Status)

Chỉ có đầu ra. 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ác câu trả lời của người đánh giá về việc phê duyệt.
fileContentChangeBehavior

enum (FileContentChangeBehavior)

Chỉ có đầu ra. 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 Bạn chưa đặt trạng thái phê duyệt hoặc đã đặt thành một giá trị không hợp lệ.
IN_PROGRESS Quy trình phê duyệt đã bắt đầu nhưng chưa hoàn tất.
APPROVED Quy 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 Quy trình phê duyệt đã hoàn tất và mục tiêu bị từ chối.

ReviewerResponse

Phản hồi về một yêu cầu phê duyệt do một người đánh giá cụ thể thực hiện.

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

string

Đây luôn là drive#reviewerResponse.
reviewer

object (User)

Người dùng chịu trách nhiệm về câu trả lời này.
response

enum (Response)

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

Phản hồi

Các phản hồi có thể có đối với yêu cầu phê duyệt.

Enum
RESPONSE_UNSPECIFIED Phản hồ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ặt hàng.
DECLINED Người đánh giá đã từ chối mặt hàng.

FileContentChangeBehavior

Hành vi của quy trình phê duyệt khi nội dung tệp thay đổi trong khi [Trạng thái][] phê duyệt 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 này chưa đượ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 yêu cầu phê duyệt có [Status][] là IN_PROGRESS. Khi trạng thái phê duyệt là APPROVED và bạn chọn RESET_APPROVAL, 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

 Bình luận về yêu cầu phê duyệt.

decline

 Từ chối yêu cầu phê duyệt.

get

 Nhận một yêu cầu 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.