이 페이지는 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 }, "createdDate": 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
  },
  "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`입니다.
`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.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`	공유 드라이브의 메타데이터를 업데이트합니다.

REST Resource: drives

리소스: Drive

메서드

`delete`

`get`

`hide`

`insert`

`list`

`unhide`

`update`