Method: approvals.cancel

承認を取り消します。承認 StatusCANCELLED に更新します。

これは、承認 StatusIN_PROGRESS のときに、ファイルに対する writer 権限を持つユーザーが呼び出すことができます。

HTTP リクエスト

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

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

パスパラメータ

パラメータ
fileId

string

必須。承認の対象となるファイルの ID。

approvalId

string

必須。キャンセルする承認の ID。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現
{
  "message": string
}
フィールド
message

string

省略可。承認の取り消しに伴うメッセージ。このメッセージは、アクションの通知と承認アクティビティ ログに含まれます。

レスポンスの本文

成功した場合、レスポンスの本文には Approval のインスタンスが含まれます。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata

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