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

审核者对审批做出的回答。

状态

审批可能具有的状态。

枚举
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 审核者已拒绝该项。

方法

approve

 批准审批。

cancel

 取消审批。

comment

 对审批发表评论。

decline

 拒绝审批。

get

 根据 ID 获取审批。

list

 列出文件中的审批。

reassign

 重新分配审批的审核者。

start

 开始对文件进行审批。