Method: approvals.start

파일에 대한 승인을 시작합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
fileId

string

필수 항목입니다. 승인이 생성될 파일의 ID입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "reviewerEmails": [
    string
  ],
  "dueTime": string,
  "lockFile": boolean,
  "message": string
}
필드
reviewerEmails[]

string

필수 항목입니다. 승인을 검토하도록 설정된 사용자의 이메일입니다.

dueTime

string (Timestamp format)

선택사항입니다. 승인 마감일입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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

일부 범위는 제한되어 있으며 앱에서 이를 사용하려면 보안 평가가 필요합니다. 자세한 내용은 승인 가이드를 참고하세요.