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로 설정하면 파일 ID 매개변수가 공유 드라이브를 참조하고 요청자가 공유 드라이브가 속한 도메인의 관리자인 경우 요청자에게 액세스 권한이 부여됩니다.

요청 본문

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

응답 본문

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

승인 범위

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

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

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