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

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