REST Resource: drives

리소스: Drive

공유 드라이브를 나타냅니다.

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

JSON 표현
{
  "id": string,
  "name": string,
  "colorRgb": string,
  "kind": string,
  "backgroundImageLink": string,
  "capabilities": {
    "canAddChildren": boolean,
    "canComment": boolean,
    "canCopy": boolean,
    "canDeleteDrive": boolean,
    "canDownload": boolean,
    "canEdit": boolean,
    "canListChildren": boolean,
    "canManageMembers": boolean,
    "canReadRevisions": boolean,
    "canRename": boolean,
    "canRenameDrive": boolean,
    "canChangeDriveBackground": boolean,
    "canShare": boolean,
    "canChangeCopyRequiresWriterPermissionRestriction": boolean,
    "canChangeDomainUsersOnlyRestriction": boolean,
    "canChangeDriveMembersOnlyRestriction": boolean,
    "canChangeSharingFoldersRequiresOrganizerPermissionRestriction": boolean,
    "canResetDriveRestrictions": boolean,
    "canDeleteChildren": boolean,
    "canTrashChildren": boolean
  },
  "themeId": string,
  "backgroundImageFile": {
    "id": string,
    "xCoordinate": number,
    "yCoordinate": number,
    "width": number
  },
  "createdDate": string,
  "hidden": boolean,
  "restrictions": {
    "copyRequiresWriterPermission": boolean,
    "domainUsersOnly": boolean,
    "driveMembersOnly": boolean,
    "adminManagedRestrictions": boolean,
    "sharingFoldersRequiresOrganizerPermission": boolean
  },
  "orgUnitId": string
}
필드
id

string

출력 전용. 공유 드라이브의 ID로, 이 공유 드라이브의 최상위 폴더 ID이기도 합니다.

name

string

이 공유 드라이브의 이름입니다.

colorRgb

string

RGB 16진수 문자열로 된 이 공유 드라이브의 색상입니다. themeId를 설정하지 않는 drive.drives.update 요청에서만 설정할 수 있습니다.

kind

string

출력 전용. 항상 drive#drive입니다.

capabilities

object

출력 전용. 현재 사용자가 이 공유 드라이브에 사용할 수 있는 기능입니다.

capabilities.canAddChildren

boolean

출력 전용. 현재 사용자가 이 공유 드라이브의 폴더에 자녀를 추가할 수 있는지 여부입니다.

capabilities.canComment

boolean

출력 전용. 현재 사용자가 이 공유 드라이브의 파일에 댓글을 쓸 수 있는지 여부입니다.

capabilities.canCopy

boolean

출력 전용. 현재 사용자가 이 공유 드라이브의 파일을 복사할 수 있는지 여부입니다.

capabilities.canDeleteDrive

boolean

출력 전용. 현재 사용자가 이 공유 드라이브를 삭제할 수 있는지 여부입니다. 공유 드라이브에 삭제 처리되지 않은 항목이 있는 경우 공유 드라이브 삭제 시도가 실패할 수 있습니다.

capabilities.canDownload

boolean

출력 전용. 현재 사용자가 이 공유 드라이브의 파일을 다운로드할 수 있는지 여부입니다.

capabilities.canEdit

boolean

출력 전용. 현재 사용자가 이 공유 드라이브의 파일을 수정할 수 있는지 여부입니다.

capabilities.canListChildren

boolean

출력 전용. 현재 사용자가 이 공유 드라이브에 폴더의 하위 항목을 나열할 수 있는지 여부입니다.

capabilities.canManageMembers

boolean

출력 전용. 현재 사용자가 이 공유 드라이브에 멤버를 추가할 수 있는지, 멤버를 삭제할 수 있는지, 멤버의 역할을 변경할 수 있는지를 나타냅니다.

capabilities.canReadRevisions

boolean

출력 전용. 현재 사용자가 이 공유 드라이브 파일의 버전 리소스를 읽을 수 있는지 여부입니다.

capabilities.canRename

boolean

출력 전용. 현재 사용자가 이 공유 드라이브의 파일 또는 폴더의 이름을 변경할 수 있는지 여부

capabilities.canRenameDrive

boolean

출력 전용. 현재 사용자가 이 공유 드라이브의 이름을 변경할 수 있는지 여부입니다.

capabilities.canChangeDriveBackground

boolean

출력 전용. 현재 사용자가 이 공유 드라이브의 배경을 변경할 수 있는지 여부입니다.

capabilities.canShare

boolean

출력 전용. 현재 사용자가 이 공유 드라이브의 파일 또는 폴더를 공유할 수 있는지 여부

capabilities.canChangeCopyRequiresWriterPermissionRestriction

boolean

출력 전용. 현재 사용자가 이 공유 드라이브의 copyRequiresWriterPermission 제한을 변경할 수 있는지 여부입니다.

capabilities.canChangeDomainUsersOnlyRestriction

boolean

출력 전용. 현재 사용자가 이 공유 드라이브의 domainUsersOnly 제한을 변경할 수 있는지 여부입니다.

capabilities.canChangeDriveMembersOnlyRestriction

boolean

출력 전용. 현재 사용자가 이 공유 드라이브의 driveMembersOnly 제한을 변경할 수 있는지 여부입니다.

capabilities.canChangeSharingFoldersRequiresOrganizerPermissionRestriction

boolean

출력 전용. 현재 사용자가 이 공유 드라이브의 sharingFoldersRequiresOrganizerPermission 제한을 변경할 수 있는지 여부입니다.

capabilities.canResetDriveRestrictions

boolean

출력 전용. 현재 사용자가 공유 드라이브 제한을 기본값으로 재설정할 수 있는지 여부입니다.

capabilities.canDeleteChildren

boolean

출력 전용. 현재 사용자가 이 공유 드라이브의 폴더에서 자녀를 삭제할 수 있는지 여부입니다.

capabilities.canTrashChildren

boolean

출력 전용. 현재 사용자가 이 공유 드라이브의 폴더에서 하위 항목을 휴지통으로 이동할 수 있는지 여부입니다.

themeId

string

배경 이미지 및 색상이 설정될 테마 ID입니다. 가능한 driveThemes 집합은 drive.about.get 응답에서 가져올 수 있습니다. drive.drives.insert 요청에 지정되지 않으면 배경 이미지와 색상이 설정되는 무작위 테마가 선택됩니다. 쓰기 전용 필드입니다. colorRgb 또는 backgroundImageFile를 설정하지 않는 요청에만 설정할 수 있습니다.

backgroundImageFile

object

이 공유 드라이브의 배경 이미지가 설정된 이미지 파일 및 자르기 매개변수입니다. 쓰기 전용 필드입니다. themeId를 설정하지 않는 drive.drives.update 요청에서만 설정할 수 있습니다. 이 플래그를 지정하면 backgroundImageFile의 모든 필드를 설정해야 합니다.

backgroundImageFile.id

string

배경 이미지에 사용할 Google Drive의 이미지 파일 ID입니다.

backgroundImageFile.xCoordinate

number

배경 이미지에서 자르기 영역의 왼쪽 상단 모서리의 X 좌표입니다. 0에서 1 사이의 닫힌 범위의 값입니다. 이 값은 전체 이미지 왼쪽에서 자르기 영역의 왼쪽까지의 가로 거리를 전체 이미지의 너비로 나눈 값을 나타냅니다.

backgroundImageFile.yCoordinate

number

배경 이미지에서 자르기 영역의 왼쪽 상단 모서리의 Y 좌표입니다. 0에서 1 사이의 닫힌 범위의 값입니다. 이 값은 전체 이미지 상단에서 자르기 영역의 상단 측면까지의 세로 거리를 전체 이미지의 높이로 나눈 값을 나타냅니다.

backgroundImageFile.width

number

0~1의 닫힌 범위에서 잘린 이미지의 너비입니다. 이 값은 잘린 이미지의 너비를 전체 이미지의 너비로 나눈 값을 나타냅니다. 높이는 80:9의 너비와 높이의 가로세로 비율을 적용하여 계산됩니다. 최종 이미지는 최소 너비 1280픽셀, 높이 144픽셀 이상이어야 합니다.

createdDate

string

출력 전용. 공유 드라이브가 생성된 시간입니다 (RFC 3339 날짜 및 시간).

hidden

boolean

공유 드라이브를 기본 뷰에서 숨길지 여부입니다.

restrictions

object

이 공유 드라이브 또는 공유 드라이브 내의 항목에 적용되는 일련의 제한사항입니다.

restrictions.copyRequiresWriterPermission

boolean

읽기 및 댓글 작성자의 경우 공유 드라이브 내의 파일 복사, 인쇄, 다운로드 옵션을 사용 중지해야 합니다. 제한사항을 true로 설정하면 공유 드라이브 내 모든 파일에 대해 비슷한 이름의 필드가 true(으)로 재정의됩니다.

restrictions.domainUsersOnly

boolean

이 공유 드라이브와 공유 드라이브 내의 항목에 대한 액세스를 이 공유 드라이브가 속한 도메인의 사용자로 제한할지 여부입니다. 이 공유 드라이브 외부에서 제어되는 다른 공유 정책으로 인해 이 제한이 재정의될 수 있습니다.

restrictions.driveMembersOnly

boolean

이 공유 드라이브 내의 항목에 대한 액세스 권한을 멤버로 제한할지 여부입니다.

restrictions.adminManagedRestrictions

boolean

제한사항을 수정하기 위해 이 공유 드라이브의 관리 권한이 필요한지 여부입니다.

restrictions.sharingFoldersRequiresOrganizerPermission

boolean

true인 경우 주최자 역할이 있는 사용자만 폴더를 공유할 수 있습니다. false인 경우 주최자 역할 또는 파일 관리자 역할이 있는 사용자는 폴더를 공유할 수 있습니다.

orgUnitId

string

출력 전용. 이 공유 드라이브의 조직 단위입니다. 이 필드는 useDomainAdminAccess 매개변수가 true로 설정된 경우 drives.list 응답에서만 채워집니다.

방법

delete

사용자가 organizer 상태인 공유 드라이브를 완전히 삭제합니다.

get

ID별로 공유 드라이브의 메타데이터를 가져옵니다.

hide

공유 드라이브를 기본 뷰에서 숨깁니다.

insert

새 공유 드라이브를 만듭니다.

list

사용자의 공유 드라이브를 나열합니다.

unhide

공유 드라이브를 기본 보기로 복원합니다.

update

공유 드라이브의 메타데이터를 업데이트합니다.