Method: approvals.cancel

取消核准。將核准狀態 Status 更新為 CANCELLED

只要使用者對檔案具有 writer 權限,且核准狀態為 IN_PROGRESS,即可呼叫此函式。Status

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
fileId

string

必填。核准要求的檔案 ID。

approvalId

string

必填。要取消的核准 ID。

要求主體

要求主體會包含結構如下的資料:

JSON 表示法
{
  "message": string
}
欄位
message

string

(選用步驟) 隨附取消核准的訊息。這則訊息會納入動作的通知和「核准活動記錄」中。

回應主體

如果成功,回應主體會包含 Approval 的執行個體。

授權範圍

需要下列其中一種 OAuth 範圍:

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

部分範圍受到限制,應用程式必須通過安全評估才能使用。詳情請參閱授權指南