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

REST Resource: drives

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

리소스: 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 }

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"`.
`backgroundImageLink`	`string` 출력 전용. 이 공유 드라이브의 배경 이미지에 대한 단기 링크입니다.
`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`	공유 드라이브의 메타날짜를 업데이트합니다.

REST Resource: drives

리소스: Drive

방법

`create`

`delete`

`get`

`hide`

`list`

`unhide`

`update`