REST Resource: approvals

資源：核准

核准的中繼資料。核准是指雲端硬碟項目的審查或核准程序。

JSON 表示法 
{
  "kind": string,
  "approvalId": string,
  "targetFileId": string,
  "createTime": string,
  "modifyTime": string,
  "completeTime": string,
  "dueTime": string,
  "status": enum (Status),
  "initiator": {
    object (User)
  },
  "reviewerResponses": [
    {
      object (ReviewerResponse)
    }
  ],
  "fileContentChangeBehavior": enum (FileContentChangeBehavior)
}
欄位
kind

string

一律為 drive#approval。
approvalId

string

核准 ID。
targetFileId

string

核准作業的目標檔案 ID。
createTime

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"。
modifyTime

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"。
completeTime

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"。
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"。
status

enum (Status)

要求這項資源時的核准狀態。
initiator

object (User)

提出核准要求的使用者。
reviewerResponses[]

object (ReviewerResponse)

審查人員對核准要求的回覆。
fileContentChangeBehavior

enum (FileContentChangeBehavior)

檔案內容變更時的核准行為。

狀態

核准作業可能出現的狀態。

列舉
STATUS_UNSPECIFIED 未設定核准狀態，或設定的值無效。
IN_PROGRESS 核准程序已開始，但尚未完成。
APPROVED 核准程序已完成，目標已獲核准。
CANCELLED 核准程序在完成前取消。
DECLINED 核准程序已完成，目標遭拒。

ReviewerResponse

特定審查者對核准要求的回覆。

JSON 表示法 
{
  "kind": string,
  "reviewer": {
    object (User)
  },
  "response": enum (Response)
}
欄位
kind

string

一律為 drive#reviewerResponse。
reviewer

object (User)

負責這則回覆的使用者。
response

enum (Response)

審查者對核准的回覆。

回應

核准要求的可能回應。

列舉
RESPONSE_UNSPECIFIED 回覆設為無法辨識的值。
NO_RESPONSE 審查者尚未回覆。
APPROVED 審查人員已核准項目。
DECLINED 審查者已拒絕該項目。

FileContentChangeBehavior

核准 Status 為 IN_PROGRESS 時，檔案內容變更時的核准行為。核准完成後，就不會再發生這種情況。

列舉
FILE_CONTENT_CHANGE_BEHAVIOR_UNSPECIFIED 未指定行為。
RESET_APPROVAL 如果檔案內容在核准狀態為 StatusIN_PROGRESS 時變更，任何 Response 為 APPROVED 的 ReviewerResponse 都會重設為 NO_DECISION。如果核准的Status為APPROVED，且已選取RESET_APPROVAL，檔案就會鎖定。
NO_APPROVAL_ACTION 檔案內容變更時，系統不會採取任何動作。

方法

approve

 核准核准要求。

cancel

 取消核准。

comment

 核准作業的註解。

decline

 拒絕核准。

get

 依 ID 取得核准。

list

 列出檔案的核准狀態。

reassign

 重新指派核准作業的審查人員。

start

 啟動檔案核准程序。