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,
  "fileContentChangeBehavior": enum (FileContentChangeBehavior)
}
字段
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

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

enum (FileContentChangeBehavior)

可选。文件内容发生更改时审批的行为。

响应正文

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

授权范围

需要以下 OAuth 范围之一：

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

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