이 페이지는 Cloud Translation API를 통해 번역되었습니다.

REST Resource: permissions

리소스: Permission
- JSON 표현
메서드

리소스: 권한

파일에 대한 권한입니다. 권한은 사용자, 그룹, 도메인 또는 모든 사용자에게 파일 또는 폴더 계층 구조에 대한 액세스 권한을 부여합니다.

일부 리소스 메서드 (예: permissions.update)에는 permissionId가 필요합니다. permissions.list 메서드를 사용하여 파일, 폴더, 공유 드라이브의 ID를 가져옵니다.

JSON 표현
{ "id": string, "name": string, "type": string, "role": string, "additionalRoles": [ string ], "authKey": string, "value": string, "kind": string, "withLink": boolean, "photoLink": string, "selfLink": string, "emailAddress": string, "domain": string, "etag": string, "permissionDetails": [ { "permissionType": string, "role": string, "additionalRoles": [ string ], "inheritedFrom": string, "inherited": boolean } ], "expirationDate": string, "teamDrivePermissionDetails": [ { "teamDrivePermissionType": string, "role": string, "additionalRoles": [ string ], "inheritedFrom": string, "inherited": boolean } ], "deleted": boolean, "view": string, "pendingOwner": boolean }

JSON 표현

{
  "id": string,
  "name": string,
  "type": string,
  "role": string,
  "additionalRoles": [
    string
  ],
  "authKey": string,
  "value": string,
  "kind": string,
  "withLink": boolean,
  "photoLink": string,
  "selfLink": string,
  "emailAddress": string,
  "domain": string,
  "etag": string,
  "permissionDetails": [
    {
      "permissionType": string,
      "role": string,
      "additionalRoles": [
        string
      ],
      "inheritedFrom": string,
      "inherited": boolean
    }
  ],
  "expirationDate": string,
  "teamDrivePermissionDetails": [
    {
      "teamDrivePermissionType": string,
      "role": string,
      "additionalRoles": [
        string
      ],
      "inheritedFrom": string,
      "inherited": boolean
    }
  ],
  "deleted": boolean,
  "view": string,
  "pendingOwner": boolean
}

필드
`id`	`string` 이 권한이 참조하는 사용자의 ID로, 정보 및 파일 리소스의 `permissionId`와 동일합니다. `drive.permissions.insert` 요청을 할 때는 권한 유형이 `anyone`가 아닌 경우 `id` 또는 `value` 필드 중 정확히 하나만 지정해야 합니다. `anyone`인 경우에는 `id`와 `value`가 모두 무시됩니다.
`name`	`string` 출력 전용. 이 권한의 이름입니다.
`type`	`string` 계정 유형입니다. 허용되는 값은 다음과 같습니다. `user` `group` `domain` `anyone`
`role`	`string` 이 사용자의 기본 역할입니다. 향후 새 값이 지원될 수 있지만 현재 다음 사항은 허용됩니다. `owner` `organizer` `fileOrganizer` `writer` `reader`
`additionalRoles[]`	`string` 이 사용자의 추가 역할입니다. 현재는 `commenter`만 허용되지만 앞으로 더 많은 API가 지원될 수 있습니다.
`authKey (deprecated)`	`string` 이 항목은 지원 중단되었습니다. 출력 전용. 지원이 중단되었습니다.
`value`	`string` 항목의 이메일 주소 또는 도메인 이름입니다. 삽입 중에 사용되며 응답에서는 채워지지 않습니다. `drive.permissions.insert` 요청을 할 때는 권한 유형이 `anyone`가 아닌 경우 `id` 또는 `value` 필드 중 정확히 하나만 지정해야 합니다. `anyone`인 경우에는 `id`와 `value`가 모두 무시됩니다.
`kind`	`string` 출력 전용. 항상 `drive#permission`입니다.
`withLink`	`boolean` 이 권한에 링크가 필요한지 여부입니다.
`photoLink`	`string` 출력 전용. 프로필 사진 링크(있는 경우)
`selfLink`	`string` 출력 전용. 이 권한으로 연결되는 링크
`emailAddress`	`string` 출력 전용. 이 권한이 참조하는 사용자 또는 그룹의 이메일 주소입니다. 권한 유형이 `user` 또는 `group`인 경우 표시되는 출력 전용 필드입니다.
`domain`	`string` 출력 전용. 이 권한이 참조하는 항목의 도메인 이름입니다. 권한 유형이 `user`, `group` 또는 `domain`인 경우 표시되는 출력 전용 필드입니다.
`etag`	`string` 출력 전용. 권한의 ETag입니다.
`permissionDetails[]`	`object` 출력 전용. 이 공유 드라이브 항목에 대한 권한이 상속되었는지 또는 이 항목에 직접 적용되는지에 관한 세부정보입니다. 공유 드라이브 항목에만 표시되는 출력 전용 입력란입니다.
`permissionDetails[].permissionType`	`string` 출력 전용. 이 사용자의 권한 유형입니다. 향후 새 값이 추가될 수 있지만 현재 가능한 경우는 다음과 같습니다. `file` `member`
`permissionDetails[].role`	`string` 출력 전용. 이 사용자의 기본 역할입니다. 향후 새 값이 추가될 수 있지만 현재 다음과 같은 경우가 가능합니다. `organizer` `fileOrganizer` `writer` `reader`
`permissionDetails[].additionalRoles[]`	`string` 출력 전용. 이 사용자의 추가 역할입니다. 현재는 `commenter`만 사용할 수 있지만 향후 더 많은 API가 지원될 수 있습니다.
`permissionDetails[].inheritedFrom`	`string` 출력 전용. 이 권한이 상속된 항목의 ID입니다. 출력 전용 필드입니다.
`permissionDetails[].inherited`	`boolean` 출력 전용. 이 권한의 상속 여부입니다. 이 필드는 항상 채워집니다. 출력 전용 필드입니다.
`expirationDate`	`string` 이 권한이 만료되는 시간입니다 (RFC 3339 날짜-시간). 만료일에는 다음과 같은 제한사항이 있습니다. 사용자 및 그룹 권한에 대해서만 설정할 수 있습니다. 미래의 날짜여야 합니다. 미래의 날짜는 1년 이내여야 합니다.
`teamDrivePermissionDetails[] (deprecated)`	`object` 이 항목은 지원 중단되었습니다. 출력 전용. 지원 중단됨: 대신 `permissionDetails`를 사용하세요.
`teamDrivePermissionDetails[] (deprecated).teamDrivePermissionType (deprecated)`	`string` 출력 전용. 지원 중단됨: 대신 `permissionDetails/permissionType`를 사용하세요.
`teamDrivePermissionDetails[] (deprecated).role (deprecated)`	`string` 출력 전용. 지원 중단됨: 대신 `permissionDetails/role`를 사용하세요.
`teamDrivePermissionDetails[] (deprecated).additionalRoles[] (deprecated)`	`string` 출력 전용. 지원 중단됨: 대신 `permissionDetails/additionalRoles`를 사용하세요.
`teamDrivePermissionDetails[] (deprecated).inheritedFrom (deprecated)`	`string` 출력 전용. 지원 중단됨: 대신 `permissionDetails/inheritedFrom`를 사용하세요.
`teamDrivePermissionDetails[] (deprecated).inherited (deprecated)`	`boolean` 출력 전용. 지원 중단됨: 대신 `permissionDetails/inherited`를 사용하세요.
`deleted`	`boolean` 출력 전용. 이 권한과 연결된 계정의 삭제 여부입니다. 이 필드는 사용자 및 그룹 권한에만 적용됩니다.
`view`	`string` 이 권한의 뷰를 나타냅니다. 뷰에 속하는 권한에만 채워집니다. 유일하게 지원되는 값은 `published`입니다.
`pendingOwner`	`boolean` 이 권한과 연결된 계정이 대기 중인 소유자인지 여부 공유 드라이브에 없는 파일의 `user` 유형 권한에 대해서만 채워집니다.

방법
`delete`	파일 또는 공유 드라이브에서 권한을 삭제합니다.
`get`	ID별로 권한을 가져옵니다.
`getIdForEmail`	이메일 주소의 권한 ID를 반환합니다.
`insert`	파일 또는 공유 드라이브의 권한을 삽입합니다.
`list`	파일 또는 공유 드라이브의 권한을 나열합니다.
`patch`	패치 시맨틱스를 사용하여 권한을 업데이트합니다.
`update`	권한을 업데이트합니다.

REST Resource: permissions

리소스: 권한

방법

`delete`

`get`

`getIdForEmail`

`insert`

`list`

`patch`

`update`