Method: approvals.start

开始审批文件。

HTTP 请求

POST https://www.googleapis.com/drive/v3/files/{fileId}/approvals:start

网址采用 gRPC 转码语法。

路径参数

参数
fileId

string

必需。将创建审批的文件 ID。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "reviewerEmails": [
    string
  ],
  "dueTime": string,
  "lockFile": boolean,
  "message": string
}
字段
reviewerEmails[]

string

必需。设置为审核审批的用户所用的电子邮件地址。
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"。
lockFile

boolean

可选。是否在开始审批时锁定文件。
message

string

可选。在通知审核者审批请求时要发送的消息。

响应正文

如果成功，则响应正文包含一个 Approval 实例。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata

某些范围受到限制，您的应用需要通过安全评估才能使用这些范围。如需了解详情，请参阅授权指南。