Method: permissions.update

패치 시맨틱스로 권한을 업데이트합니다. 자세한 내용은 파일, 폴더, 드라이브 공유하기를 참고하세요.

경고: 동일한 파일에 대한 동시 권한 작업은 지원되지 않으며 마지막 업데이트만 적용됩니다.

HTTP 요청

PATCH https://www.googleapis.com/drive/v3/files/{fileId}/permissions/{permissionId}

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

경로 매개변수

매개변수
fileId

string

파일 또는 공유 드라이브의 ID입니다.
permissionId

string

권한의 ID입니다.

쿼리 매개변수

매개변수
removeExpiration

boolean

만료일을 삭제할지 여부입니다.
supportsAllDrives

boolean

요청하는 애플리케이션이 내 드라이브와 공유 드라이브를 모두 지원하는지 여부입니다.
supportsTeamDrives
(deprecated)

boolean

지원 중단됨: 대신 supportsAllDrives을 사용하세요.
transferOwnership

boolean

소유권을 지정된 사용자에게 이전하고 현재 소유자를 작성자로 다운그레이드할지 여부입니다. 이 매개변수는 부작용을 확인하는 데 필요합니다. 자세한 내용은 파일 소유권 이전하기를 참고하세요.
useDomainAdminAccess

boolean

도메인 관리자로 요청을 실행합니다.

true로 설정되어 있고 다음 추가 조건이 충족되면 요청자에게 액세스 권한이 부여됩니다.

  1. 파일 ID 매개변수가 공유 드라이브를 참조합니다.
  2. 요청자가 공유 드라이브가 속한 도메인의 관리자입니다.

자세한 내용은 도메인 관리자로 공유 드라이브 관리하기를 참고하세요.
enforceExpansiveAccess

boolean

요청에서 광범위한 액세스 규칙을 적용해야 하는지 여부입니다.

요청 본문

요청 본문에 Permission의 인스턴스가 포함됩니다.

응답 본문

성공한 경우 응답 본문에 Permission의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

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