REST Resource: approvals

资源：审批

审批的元数据。审批是指对云端硬盘内容进行审核或批准的过程。

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)
}
字段
kind

string

此值始终为 drive#approval。
approvalId

string

审批 ID。
targetFileId

string

审批的目标文件 ID。
createTime

string (Timestamp format)

审批请求的创建时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
modifyTime

string (Timestamp format)

上次修改审批的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
completeTime

string (Timestamp format)

审批完成的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
dueTime

string (Timestamp format)

审批截止时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
status

enum (Status)

请求此资源时审批的状态。
initiator

object (User)

请求审批的用户。
reviewerResponses[]

object (ReviewerResponse)

审核者对审批做出的回复。
fileContentChangeBehavior

enum (FileContentChangeBehavior)

文件内容发生变化时审批的行为。

状态

审批的可能状态。

枚举
STATUS_UNSPECIFIED 审批状态尚未设置或已设置为无效值。
IN_PROGRESS 审批流程已开始，但尚未完成。
APPROVED 审批流程已完成，目标已获批准。
CANCELLED 审批流程在完成之前被取消。
DECLINED 审批流程已完成，目标已被拒绝。

ReviewerResponse

特定审核者对审批请求做出的回复。

JSON 表示法 
{
  "kind": string,
  "reviewer": {
    object (User)
  },
  "response": enum (Response)
}
字段
kind

string

此值始终为 drive#reviewerResponse。
reviewer

object (User)

负责此回答的用户。
response

enum (Response)

审核者对审批请求的回复。

响应

审批的可能响应。

枚举
RESPONSE_UNSPECIFIED 回答被设为无法识别的值。
NO_RESPONSE 审核者尚未回复。
APPROVED 审核者已批准该内容。
DECLINED 审核者已拒绝该内容。

FileContentChangeBehavior

当审批 Status 为 IN_PROGRESS 时，文件内容发生更改时审批的行为。审批完成后，此行为将不再发生。

枚举
FILE_CONTENT_CHANGE_BEHAVIOR_UNSPECIFIED 未指定行为。
RESET_APPROVAL 当文件内容发生更改且审批的 Status 为 IN_PROGRESS 时，Response 为 APPROVED 的任何 ReviewerResponse 都将重置为 NO_DECISION。如果审批的 Status 为 APPROVED，并且选择了 RESET_APPROVAL，则文件会被锁定。
NO_APPROVAL_ACTION 文件内容发生更改时，系统不会执行任何操作。

方法

approve

 批准审批。

cancel

 取消审批。

comment

 审批评论。

decline

 拒绝批准。

get

 按 ID 获取审批。

list

 列出文件的审批。

reassign

 重新分配审批的审核者。

start

 启动文件审批。