Method: approvals.reassign

重新分配审批的审核者。在审批的 ReviewerResponse 中添加或替换审核者。

当审批 StatusIN_PROGRESS 且要重新分配的审核者的 ResponseNO_RESPONSE 时,任何对文件具有 writer 权限的用户都可以调用此方法。拥有 reader 权限的用户只能重新分配已分配给自己的审批。

不允许移除审核者。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
fileId

string

必需。审批所针对的文件的 ID。

approvalId

string

必需。要重新分配的审批的 ID。

请求正文

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

JSON 表示法
{
  "addReviewers": [
    {
      object (AddReviewer)
    }
  ],
  "replaceReviewers": [
    {
      object (ReplaceReviewer)
    }
  ],
  "message": string
}
字段
addReviewers[]

object (AddReviewer)

可选。要添加的审核者列表。

replaceReviewers[]

object (ReplaceReviewer)

可选。审核者替换列表。

message

string

可选。要发送给新审核者的消息。此消息将包含在相应操作的通知和审批活动日志中。

响应正文

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

授权范围

需要以下 OAuth 范围之一:

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

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

AddReviewer

表示添加审核者。

JSON 表示法
{
  "addedReviewerEmail": string
}
字段
addedReviewerEmail

string

必需。要添加的审核者的电子邮件地址。

ReplaceReviewer

审核人员替换的表示形式。

JSON 表示法
{
  "addedReviewerEmail": string,
  "removedReviewerEmail": string
}
字段
addedReviewerEmail

string

必需。要添加的审核者的电子邮件地址。

removedReviewerEmail

string

必需。要移除的审核者的电子邮件地址。