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 承認の [ステータス][] が IN_PROGRESS のときにファイルの内容が変更されると、ReviewerResponse の Response が APPROVED のものは NO_DECISION にリセットされます。承認の [ステータス][] が APPROVED で RESET_APPROVAL が選択されている場合、ファイルはロックされます。
NO_APPROVAL_ACTION ファイルの内容が変更されても何も行われません。

メソッド

approve

 承認を承認します。

cancel

 承認を取り消します。

comment

 承認にコメントします。

decline

 承認を拒否します。

get

 ID で承認を取得します。

list

 ファイルに対する承認を一覧表示します。

reassign

 承認の審査担当者を再割り当てします。

start

 ファイルに対する承認を開始します。