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

如果檔案內容在核准 [狀態][] 為 IN_PROGRESS 時變更，核准程序的行為。核准完成後，就不會再發生這種情況。

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

方法

approve

 核准核准要求。

cancel

 取消核准。

comment

 核准作業的註解。

decline

 拒絕核准。

get

 依 ID 取得核准。

list

 列出檔案的核准狀態。

reassign

 重新指派核准審查者。

start

 對檔案啟動核准程序。