Permissions

이 리소스에 대한 메소드 목록은 이 페이지의 하단에 나와 있습니다.

리소스 표현

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

{
  "kind": "drive#permission",
  "id": string,
  "type": string,
  "emailAddress": string,
  "domain": string,
  "role": string,
  "view": string,
  "allowFileDiscovery": boolean,
  "displayName": string,
  "photoLink": string,
  "expirationTime": datetime,
  "teamDrivePermissionDetails": [
    {
      "teamDrivePermissionType": string,
      "role": string,
      "inheritedFrom": string,
      "inherited": boolean
    }
  ],
  "permissionDetails": [
    {
      "permissionType": string,
      "role": string,
      "inheritedFrom": string,
      "inherited": boolean
    }
  ],
  "deleted": boolean,
  "pendingOwner": boolean
}
숙소 이름 설명 메모
kind string 리소스 종류를 식별합니다. 값: 고정 문자열 "drive#permission".
id string 이 권한의 ID입니다. 수혜자의 고유 식별자이며 사용자 리소스에 permissionId(으)로 게시됩니다. ID는 불투명 값으로 취급해야 합니다.
type string 수혜자의 유형. 유효한 값은 다음과 같습니다.
  • user
  • group
  • domain
  • anyone
권한을 생성할 때 typeuser 또는 group인 경우 사용자 또는 그룹에 emailAddress를 제공해야 합니다. typedomain이면 domain를 제공해야 합니다. anyone 유형에는 추가 정보가 필요하지 않습니다.
쓰기 가능
emailAddress string 이 권한이 적용되는 사용자 또는 그룹의 이메일 주소입니다. 쓰기 가능
domain string 이 권한이 참조하는 도메인입니다. 현재 허용되는 옵션은 다음과 같습니다.
  • 전체 도메인(예: 'your-company.com')
  • 공유 대상 그룹(예: 'ID.audience.googledomains.com')
쓰기 가능
role string 이 권한이 부여하는 역할입니다. 향후 새 값이 지원될 수 있지만 현재 허용되는 값은 다음과 같습니다.
  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader
쓰기 가능
allowFileDiscovery boolean 권한을 통해 검색을 통해 파일을 검색할 수 있는지 여부입니다. 이는 domain 또는 anyone 유형의 권한에만 적용됩니다. 쓰기 가능
displayName string 권한 값의 'pretty' 이름입니다. 다음은 각 권한 유형의 예시 목록입니다.
  • user - Google 계정에 정의된 사용자의 전체 이름(예: 'Joe Smith')
  • group - Google 그룹의 이름입니다(예: '회사 관리자').
  • domain - 문자열 도메인 이름(예: 'your-company.com')입니다.
  • anyone: displayName가 없습니다.
expirationTime datetime 이 권한이 만료되는 시간 (RFC 3339 날짜-시간)입니다. 만료 시간에는 다음과 같은 제한사항이 있습니다.
  • 공유 드라이브 항목에는 설정할 수 없습니다.
  • 사용자 및 그룹 권한에 대해서만 설정할 수 있습니다.
  • 현재 시간 이후여야 합니다.
  • 시간은 향후 1년 이내여야 합니다.
쓰기 가능
teamDrivePermissionDetails[] list permissionDetails를 대신 사용하세요.
teamDrivePermissionDetails[].teamDrivePermissionType string permissionDetails/permissionType를 대신 사용하세요.
teamDrivePermissionDetails[].role string permissionDetails/role를 대신 사용하세요.
teamDrivePermissionDetails[].inheritedFrom string permissionDetails/inheritedFrom를 대신 사용하세요.
teamDrivePermissionDetails[].inherited boolean permissionDetails/inherited를 대신 사용하세요.
deleted boolean 이 권한과 연결된 계정이 삭제되었는지 여부입니다. 이 필드는 사용자 및 그룹 권한에만 적용됩니다.
permissionDetails[] list 이 공유 드라이브 항목의 권한이 상속되었는지 또는 이 항목에 직접 있는지에 관한 세부정보입니다. 공유 드라이브 항목에만 표시되는 출력 전용 필드입니다.
permissionDetails[].permissionType string 이 사용자의 권한 유형입니다. 향후 새 값이 추가될 수 있지만 현재 허용됩니다.
  • file
  • member
permissionDetails[].role string 이 사용자의 기본 역할 향후 새 값이 추가될 수 있지만 현재 허용됩니다.
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader
permissionDetails[].inheritedFrom string 이 권한이 상속되는 항목의 ID. 이는 출력 전용 필드입니다.
permissionDetails[].inherited boolean 이 권한이 상속되는지 여부를 나타냅니다. 이 필드는 항상 채워집니다. 이는 출력 전용 필드입니다.
view string 이 권한에 대한 뷰를 나타냅니다. 뷰에 속한 권한에 대해서만 채워집니다. 유일하게 지원되는 값은 published입니다. 쓰기 가능
pendingOwner boolean 이 권한과 연결된 계정이 대기 중인 소유자인지 여부 공유 드라이브에 없는 파일의 user 유형 권한에 대해서만 채워집니다. 쓰기 가능

방법

만들기
파일 또는 공유 드라이브에 대한 권한을 만듭니다. 권한 생성에 관한 자세한 내용은 파일, 폴더, 드라이브 공유를 참고하세요.
delete
권한을 삭제합니다.
가져오기
ID별로 권한을 가져옵니다.
list
파일 또는 공유 드라이브의 권한 목록을 표시합니다.
업데이트
패치 시맨틱스를 사용하여 권한을 업데이트합니다.