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 正規化，並使用 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

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