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

REST Resource: drives

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

리소스: Drive

공유 드라이브의 표현입니다.

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

JSON 표현

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, "canChangeDownloadRestriction": 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, "downloadRestriction": { object (`DownloadRestriction`) } }, "orgUnitId": string }

{
  "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,
    "canChangeDownloadRestriction": 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,
    "downloadRestriction": {
      object (DownloadRestriction)
    }
  },
  "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` 출력 전용입니다. 현재 사용자가 이 공유 드라이브의 폴더에서 하위 항목을 휴지통으로 이동할 수 있는지 여부입니다.
`capabilities.canChangeDownloadRestriction`	`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의 너비 대 높이 가로세로 비율을 적용하여 계산됩니다. 결과 이미지의 너비는 1,280픽셀 이상, 높이는 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인 경우, 호스트 역할 또는 파일 정리 도구 역할이 있는 사용자가 폴더를 공유할 수 있습니다.
`restrictions.downloadRestriction`	`object (DownloadRestriction)` 공유 드라이브 관리자가 적용한 다운로드 제한사항
`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`

REST Resource: drives 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

리소스: Drive

메서드

create

delete

get

hide

list

unhide

update

REST Resource: drives

`create`

`delete`

`get`

`hide`

`list`

`unhide`

`update`