Method: permissions.create

파일 또는 공유 드라이브의 권한을 만듭니다. 자세한 내용은 파일, 폴더, 드라이브 공유하기를 참고하세요.

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

HTTP 요청

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

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

경로 매개변수

매개변수
fileId

string

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

쿼리 매개변수

매개변수
emailMessage

string

알림 이메일에 포함할 일반 텍스트 맞춤 메시지입니다.
enforceSingleParent
(deprecated)

boolean

지원 중단됨: 자세한 내용은 moveToNewOwnersRoot을 참고하세요.
moveToNewOwnersRoot

boolean

이 매개변수는 항목이 공유 드라이브에 없고 요청이 항목의 소유권을 이전하려고 하는 경우에만 적용됩니다. true로 설정하면 항목이 새 소유자의 내 드라이브 루트 폴더로 이동되고 이전 상위 항목이 모두 삭제됩니다. false로 설정된 경우 부모가 변경되지 않습니다.
sendNotificationEmail

boolean

사용자 또는 그룹에 공유할 때 알림 이메일을 보낼지 여부입니다. 사용자와 그룹의 경우 기본값은 true이며 다른 요청에는 허용되지 않습니다. 소유권 이전을 위해 사용 중지해서는 안 됩니다.
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

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