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
  },
  "createdTime": 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.create 요청에 지정되지 않으면 배경 이미지와 색상이 설정되는 임의의 테마가 선택됩니다. 쓰기 전용 필드입니다. 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픽셀 이상이어야 합니다.

createdTime

string

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

hidden

boolean

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

restrictions

object

이 공유 드라이브 또는 공유 드라이브 내 항목에 적용되는 제한사항입니다. 공유 드라이브를 만들 때는 제한을 설정할 수 없습니다. 제한사항을 추가하려면 먼저 공유 드라이브를 만든 다음 drives.update을(를) 사용하여 제한사항을 추가하세요.

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 응답에만 채워집니다.

메서드

create

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

delete

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

get

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

hide

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

list

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

unhide

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

update

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