Permissions: create

파일 또는 공유 드라이브에 대한 권한을 만듭니다. 권한 생성에 관한 자세한 내용은 파일, 폴더, 드라이브 공유를 참고하세요. 지금 사용해보기

요청

HTTP 요청

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

매개변수

매개변수 이름 값 설명
경로 매개변수
fileId string 파일 또는 공유 드라이브의 ID입니다.
쿼리 매개변수(선택사항)
emailMessage string 알림 이메일에 포함할 일반 텍스트 맞춤 메시지입니다.
enforceSingleParent boolean 지원이 중단되었습니다. 자세한 내용은 moveToNewOwnersRoot를 참고하세요. (기본값: false)
fields string 응답에 포함할 필드의 경로입니다. 지정하지 않으면 응답에 이 메서드와 관련된 기본 필드 세트가 포함됩니다. 개발의 경우 특수 값 *을 사용하여 모든 필드를 반환할 수 있지만 필요한 필드만 선택하면 성능이 향상됩니다. 자세한 내용은 파일의 특정 필드 반환하기를 참고하세요.
moveToNewOwnersRoot boolean 이 매개변수는 항목이 공유 드라이브에 없고 요청 항목에서 항목 소유권 이전을 시도하는 경우에만 적용됩니다. true로 설정하면 항목이 새 소유자의 내 드라이브 루트 폴더로 이동되고 이전의 모든 상위 항목이 삭제됩니다. false로 설정하면 상위 항목이 변경되지 않습니다. (기본값: false)
sendNotificationEmail boolean 사용자 또는 그룹에 공유할 때 알림 이메일을 보낼지 여부입니다. 기본값은 사용자 및 그룹의 경우 true이며 다른 요청에서는 허용되지 않습니다. 소유권 이전에 사용 중지해서는 안 됩니다.
supportsAllDrives boolean 요청하는 애플리케이션이 내 드라이브와 공유 드라이브를 모두 지원하는지 여부 (기본값: false)
supportsTeamDrives boolean 지원 중단된 SupportAllDrives를 대신 사용하세요. (기본값: false)
transferOwnership boolean 지정된 사용자에게 소유권을 이전하고 현재 소유자를 작성자로 다운그레이드할지 여부입니다. 이 매개변수는 부작용을 확인하는 데 필요합니다. 파일 소유자는 내 드라이브에 있는 파일의 소유권만 이전할 수 있습니다. 공유 드라이브에 있는 파일은 해당 공유 드라이브를 소유한 조직에서 소유하며, 공유 드라이브의 파일 및 폴더에서는 소유권 이전이 지원되지 않습니다. 공유 드라이브의 주최자는 공유 드라이브의 항목을 내 드라이브로 이동하여 소유권을 이전할 수 있습니다. (기본값: false)
useDomainAdminAccess boolean 도메인 관리자로 요청을 실행합니다. true로 설정된 경우, 파일 ID 매개변수가 공유 드라이브를 참조하고 요청자가 공유 드라이브가 속한 도메인의 관리자인 경우 요청자에게 액세스 권한이 부여됩니다. (기본값: false)

승인

이 요청에는 다음 범위 중 하나 이상을 포함한 승인이 필요합니다.

범위
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file

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

요청 본문

요청 본문에서는 다음과 같은 속성을 사용하여 권한 리소스를 제공합니다.

숙소 이름 값 설명 메모
필수 속성
role string 이 권한이 부여하는 역할입니다. 향후 새 값이 지원될 수 있지만 현재 허용되는 값은 다음과 같습니다.
  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader
 쓰기 가능
type string 수혜자의 유형. 유효한 값은 다음과 같습니다.
  • user
  • group
  • domain
  • anyone
권한을 생성할 때 type가 user 또는 group인 경우 사용자 또는 그룹에 emailAddress를 제공해야 합니다. type가 domain이면 domain를 제공해야 합니다. anyone 유형에는 추가 정보가 필요하지 않습니다.		 쓰기 가능
선택 속성
allowFileDiscovery boolean 권한을 통해 검색을 통해 파일을 검색할 수 있는지 여부입니다. 이는 domain 또는 anyone 유형의 권한에만 적용됩니다. 쓰기 가능
domain string 이 권한이 참조하는 도메인입니다. 현재 허용되는 옵션은 다음과 같습니다.
  • 전체 도메인(예: 'your-company.com')
  • 공유 대상 그룹(예: 'ID.audience.googledomains.com')
 쓰기 가능
emailAddress string 이 권한이 적용되는 사용자 또는 그룹의 이메일 주소입니다. 쓰기 가능
expirationTime datetime 이 권한이 만료되는 시간 (RFC 3339 날짜-시간)입니다. 만료 시간에는 다음과 같은 제한사항이 있습니다.
  • 공유 드라이브 항목에는 설정할 수 없습니다.
  • 사용자 및 그룹 권한에 대해서만 설정할 수 있습니다.
  • 현재 시간 이후여야 합니다.
  • 시간은 향후 1년 이내여야 합니다.
 쓰기 가능
pendingOwner boolean 이 권한과 연결된 계정이 대기 중인 소유자인지 여부 공유 드라이브에 없는 파일의 user 유형 권한에 대해서만 채워집니다. 쓰기 가능
view string 이 권한에 대한 뷰를 나타냅니다. 뷰에 속한 권한에 대해서만 채워집니다. 유일하게 지원되는 값은 published입니다. 쓰기 가능

응답

요청에 성공할 경우 이 메서드는 응답 본문에서 권한 리소스를 반환합니다.

사용해 보기

아래의 API 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.