Method: approvals.reassign

重新指派核准審查者。詳情請參閱「管理核准」。

在核准的 ReviewerResponse 中新增或取代審查者。

只要使用者對檔案具有 writer 權限，且核准 Status 處於 IN_PROGRESS 狀態，並為重新指派的審查者設定 Response 為 NO_RESPONSE，即可呼叫此函式。具備 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

必填。要移除的審查人員電子郵件地址。