패치 시맨틱스를 사용하여 권한을 업데이트합니다. 지금 사용해 보기
요청
HTTP 요청
PATCH https://www.googleapis.com/drive/v3/files/fileId/permissions/permissionId
매개변수
| 매개변수 이름 | 값 | 설명 |
|---|---|---|
| 경로 매개변수 | ||
fileId |
string |
파일 또는 공유 드라이브의 ID입니다. |
permissionId |
string |
권한의 ID입니다. |
| 쿼리 매개변수(선택사항) | ||
fields |
string |
응답에 포함할 필드의 경로입니다. 지정하지 않으면 응답에 이 메서드와 관련된 기본 필드 세트가 포함됩니다. 개발의 경우 특수 값 *을 사용하여 모든 필드를 반환할 수 있지만 필요한 필드만 선택하면 성능이 향상됩니다. 자세한 내용은 파일의 특정 필드 반환하기를 참고하세요.
|
removeExpiration |
boolean |
만료일을 삭제할지 여부입니다.
(기본값: false)
|
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 |
일부 범위는 제한되어 있으며 앱에서 이를 사용하려면 보안 평가가 필요합니다. 자세한 내용은 인증 및 승인 페이지를 참고하세요.
요청 본문
요청 본문에 패치 의미 체계 규칙에 따라 권한 리소스의 관련 부분에 다음 속성을 제공합니다.
| 숙소 이름 | 값 | 설명 | 메모 |
|---|---|---|---|
| 선택 속성 | |||
expirationTime |
datetime |
이 권한이 만료되는 시간 (RFC 3339 날짜-시간)입니다. 만료 시간에는 다음과 같은 제한사항이 있습니다.
|
쓰기 가능 |
pendingOwner |
boolean |
이 권한과 연결된 계정이 대기 중인 소유자인지 여부 공유 드라이브에 없는 파일의 user 유형 권한에 대해서만 채워집니다. |
쓰기 가능 |
role |
string |
이 권한이 부여하는 역할입니다. 향후 새 값이 지원될 수 있지만 현재 허용되는 값은 다음과 같습니다.
|
쓰기 가능 |
view |
string |
이 권한에 대한 뷰를 나타냅니다. 뷰에 속한 권한에 대해서만 채워집니다. 유일하게 지원되는 값은 published입니다. |
쓰기 가능 |
응답
요청에 성공할 경우 이 메서드는 응답 본문에서 권한 리소스를 반환합니다.
사용해 보기
아래의 API 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.