Method: approvals.start

ファイルの承認を開始します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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

一部のスコープは制限されており、アプリでそれらを使用するにはセキュリティ評価が必要です。詳しくは、承認ガイドをご覧ください。