REST Resource: approvals

资源：Approval

审批的元数据。审批是指对云端硬盘项的审核或批准流程。

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 时，如果文件内容发生变化，则所有 ReviewerResponse 且 Response 为 APPROVED 的审批都将重置为 NO_DECISION。当审批 [Status][] 为 APPROVED 且选择了 RESET_APPROVAL 时，文件将被锁定。
NO_APPROVAL_ACTION 文件内容发生变化时，系统不会采取任何操作。

方法

approve

 批准审批。

cancel

 取消审批。

comment

 对审批发表评论。

decline

 拒绝审批。

get

 根据 ID 获取审批。

list

 列出文件中的审批。

reassign

 重新分配审批的审核人员。

start

 开始对文件进行审批。