파일 또는 공유 드라이브에 대한 권한을 생성합니다.
경고: 동일한 파일에 대한 동시 권한 작업은 지원되지 않으며 마지막 업데이트만 적용됩니다.
HTTP 요청
POST https://www.googleapis.com/drive/v3/files/{fileId}/permissions
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
| 매개변수 | |
|---|---|
fileId |
파일 또는 공유 드라이브의 ID입니다. |
쿼리 매개변수
| 매개변수 | |
|---|---|
emailMessage |
알림 이메일에 포함할 일반 텍스트 맞춤 메시지입니다. |
enforceSingleParent |
지원 중단됨: 자세한 내용은 |
moveToNewOwnersRoot |
이 매개변수는 항목이 공유 드라이브에 없고 요청에서 항목의 소유권을 이전하려는 경우에만 적용됩니다. |
sendNotificationEmail |
사용자 또는 그룹에 공유할 때 알림 이메일을 보낼지 여부입니다. 사용자 및 그룹의 기본값은 true이며 다른 요청에는 허용되지 않습니다. 소유권 이전에 대해 사용 중지해서는 안 됩니다. |
supportsAllDrives |
요청하는 애플리케이션에서 내 드라이브와 공유 드라이브를 모두 지원하는지 여부 |
supportsTeamDrives |
지원 중단됨: 대신 |
transferOwnership |
지정된 사용자에게 소유권을 이전하고 현재 소유자를 작성자로 다운그레이드할지 여부입니다. 이 매개변수는 부작용을 확인하기 위해 필요합니다. |
useDomainAdminAccess |
도메인 관리자로 요청을 실행합니다. true로 설정하면 파일 ID 매개변수가 공유 드라이브를 참조하고 요청자가 공유 드라이브가 속한 도메인의 관리자이면 요청자에게 액세스 권한이 부여됩니다. |
요청 본문
요청 본문에는 Permission의 인스턴스가 포함됩니다.
응답 본문
성공한 경우 응답 본문에 새로 생성된 Permission의 인스턴스가 포함됩니다.
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.file
일부 범위가 제한되며 앱에서 사용하려면 보안 평가가 필요합니다. 자세한 내용은 승인 가이드를 참고하세요.