REST Resource: files

리소스: 파일

파일의 메타데이터입니다.

일부 리소스 메서드 (예: files.update)에는 fileId가 필요합니다. files.list 메서드를 사용하여 파일의 ID를 검색합니다.

JSON 표현
{
  "kind": string,
  "userPermission": {
    object (Permission)
  },
  "fileExtension": string,
  "md5Checksum": string,
  "selfLink": string,
  "ownerNames": [
    string
  ],
  "lastModifyingUserName": string,
  "editable": boolean,
  "writersCanShare": boolean,
  "downloadUrl": string,
  "mimeType": string,
  "exportLinks": {
    string: string,
    ...
  },
  "driveId": string,
  "parents": [
    {
      object (ParentReference)
    }
  ],
  "thumbnailLink": string,
  "appDataContents": boolean,
  "webViewLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "owners": [
    {
      object (User)
    }
  ],
  "openWithLinks": {
    string: string,
    ...
  },
  "defaultOpenWithLink": string,
  "headRevisionId": string,
  "properties": [
    {
      object (Property)
    }
  ],
  "copyable": boolean,
  "etag": string,
  "sharingUser": {
    object (User)
  },
  "alternateLink": string,
  "embedLink": string,
  "webContentLink": string,
  "fileSize": string,
  "copyRequiresWriterPermission": boolean,
  "permissions": [
    {
      object (Permission)
    }
  ],
  "hasThumbnail": boolean,
  "spaces": [
    string
  ],
  "folderColorRgb": string,
  "id": string,
  "title": string,
  "description": string,
  "labels": {
    "viewed": boolean,
    "restricted": boolean,
    "starred": boolean,
    "hidden": boolean,
    "trashed": boolean,
    "modified": boolean
  },
  "explicitlyTrashed": boolean,
  "createdDate": string,
  "modifiedDate": string,
  "modifiedByMeDate": string,
  "lastViewedByMeDate": string,
  "markedViewedByMeDate": string,
  "sharedWithMeDate": string,
  "quotaBytesUsed": string,
  "version": string,
  "indexableText": {
    "text": string
  },
  "originalFilename": string,
  "ownedByMe": boolean,
  "canComment": boolean,
  "shareable": boolean,
  "fullFileExtension": string,
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeRestrictedDownload": boolean,
    "canMoveChildrenOutOfDrive": boolean,
    "canReadDrive": boolean,
    "canEdit": boolean,
    "canCopy": boolean,
    "canComment": boolean,
    "canAddChildren": boolean,
    "canDelete": boolean,
    "canDownload": boolean,
    "canListChildren": boolean,
    "canRemoveChildren": boolean,
    "canRename": boolean,
    "canTrash": boolean,
    "canReadRevisions": boolean,
    "canReadTeamDrive": boolean,
    "canMoveTeamDriveItem": boolean,
    "canChangeCopyRequiresWriterPermission": boolean,
    "canMoveItemIntoTeamDrive": boolean,
    "canUntrash": boolean,
    "canModifyContent": boolean,
    "canMoveItemWithinTeamDrive": boolean,
    "canMoveItemOutOfTeamDrive": boolean,
    "canDeleteChildren": boolean,
    "canMoveChildrenOutOfTeamDrive": boolean,
    "canMoveChildrenWithinTeamDrive": boolean,
    "canTrashChildren": boolean,
    "canMoveItemOutOfDrive": boolean,
    "canAddMyDriveParent": boolean,
    "canRemoveMyDriveParent": boolean,
    "canMoveItemWithinDrive": boolean,
    "canShare": boolean,
    "canMoveChildrenWithinDrive": boolean,
    "canModifyContentRestriction": boolean,
    "canAddFolderFromAnotherDrive": boolean,
    "canChangeSecurityUpdateEnabled": boolean,
    "canAcceptOwnership": boolean,
    "canReadLabels": boolean,
    "canModifyLabels": boolean,
    "canModifyEditorContentRestriction": boolean,
    "canModifyOwnerContentRestriction": boolean,
    "canRemoveContentRestriction": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "canReadRevisions": boolean,
  "thumbnailVersion": string,
  "trashedDate": string,
  "permissionIds": [
    string
  ],
  "thumbnail": {
    "image": string,
    "mimeType": string
  },
  "imageMediaMetadata": {
    "flashUsed": boolean,
    "meteringMode": string,
    "sensor": string,
    "exposureMode": string,
    "colorSpace": string,
    "whiteBalance": string,
    "width": integer,
    "height": integer,
    "location": {
      "latitude": number,
      "longitude": number,
      "altitude": number
    },
    "rotation": integer,
    "date": string,
    "cameraMake": string,
    "cameraModel": string,
    "exposureTime": number,
    "aperture": number,
    "focalLength": number,
    "isoSpeed": integer,
    "exposureBias": number,
    "maxApertureValue": number,
    "subjectDistance": integer,
    "lens": string
  },
  "videoMediaMetadata": {
    "width": integer,
    "height": integer,
    "durationMillis": string
  },
  "shortcutDetails": {
    "targetId": string,
    "targetMimeType": string,
    "targetResourceKey": string
  },
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string
}
필드
kind

string

출력 전용입니다. 파일 형식. 항상 drive#file입니다.

userPermission

object (Permission)

출력 전용입니다. 이 파일에 대한 인증된 사용자의 권한입니다.

fileExtension

string

출력 전용입니다. fullFileExtension의 마지막 구성요소에서 후행 텍스트가 확장 프로그램의 일부가 아닌 것으로 삭제되었습니다. 이 필드는 Google Drive에 저장된 콘텐츠가 있는 파일에 대해서만 채워집니다. Docs 편집기 또는 바로가기 파일의 경우 채워지지 않습니다.

md5Checksum

string

출력 전용입니다. 이 파일 콘텐츠의 MD5 체크섬입니다. 이 필드는 Google Drive에 저장된 콘텐츠가 있는 파일에 대해서만 채워집니다. Docs 편집기 또는 바로가기 파일의 경우 채워지지 않습니다.

ownerNames[]

string

출력 전용입니다. 이 파일 소유자의 이름입니다. 공유 드라이브 내 항목에는 채워지지 않습니다.

lastModifyingUserName

string

출력 전용입니다. 이 파일을 수정한 마지막 사용자의 이름입니다.

editable
(deprecated)

boolean

출력 전용입니다. 지원 중단됨: 대신 capabilities/canEdit를 사용하세요.

writersCanShare

boolean

작성자가 다른 사용자와 문서를 공유할 수 있는지 여부입니다. 공유 드라이브 내 항목에는 채워지지 않습니다.

downloadUrl

string

출력 전용입니다. 파일의 단기 다운로드 URL입니다. 이 필드는 Google Drive에 저장된 콘텐츠가 있는 파일에 대해서만 채워집니다. Google Docs나 바로가기 파일의 경우 채워지지 않습니다.

mimeType

string

파일의 MIME 유형입니다. 새 콘텐츠를 업로드할 때 업데이트 시에만 변경할 수 있습니다. 이 입력란은 비워 둘 수 있으며 MIME 유형은 업로드된 콘텐츠의 MIME 유형에 따라 결정됩니다.

driveId

string

출력 전용입니다. 파일이 있는 공유 드라이브의 ID입니다. 공유 드라이브의 항목에만 채워집니다.

parents[]

object (ParentReference)

파일이 포함된 상위 폴더의 ID입니다.

파일에는 상위 폴더가 하나만 있을 수 있습니다. 여러 상위 항목을 지정하는 기능은 지원되지 않습니다.

삽입 요청의 일부로 지정하지 않으면 파일이 사용자의 내 드라이브 폴더에 직접 배치됩니다. 복사 요청의 일부로 지정되지 않으면 파일은 소스 파일에서 검색 가능한 모든 상위 파일을 상속합니다. files.update 요청은 addParentsremoveParents 매개변수를 사용하여 상위 목록을 수정해야 합니다.

appDataContents

boolean

출력 전용입니다. 이 파일이 애플리케이션 데이터 폴더에 있는지 여부입니다.

shared

boolean

출력 전용입니다. 파일 공유 여부입니다. 공유 드라이브 내 항목에는 채워지지 않습니다.

lastModifyingUser

object (User)

출력 전용입니다. 이 파일을 수정한 마지막 사용자입니다. 이 필드는 로그인한 사용자가 마지막으로 수정한 경우에만 채워집니다.

owners[]

object (User)

출력 전용입니다. 이 파일의 소유자입니다. 일부 기존 파일에만 소유자가 2명 이상 있을 수 있습니다. 공유 드라이브의 항목에는 이 필드가 채워지지 않습니다.

headRevisionId

string

출력 전용입니다. 파일 헤드 버전의 ID입니다. 이 필드는 Google Drive에 저장된 콘텐츠가 있는 파일에 대해서만 채워집니다. Docs 편집기 또는 바로가기 파일의 경우 채워지지 않습니다.

properties[]

object (Property)

속성 목록입니다.

copyable
(deprecated)

boolean

출력 전용입니다. 지원 중단됨: 대신 capabilities/canCopy를 사용하세요.

etag

string

출력 전용입니다. 파일의 ETag입니다.

sharingUser

object (User)

출력 전용입니다. 현재 사용자와 항목을 공유한 사용자입니다(가능한 경우).

fileSize

string (int64 format)

출력 전용입니다. blob 및 퍼스트 파티 편집기 파일의 크기(바이트)입니다. 바로가기, 폴더와 같이 크기가 없는 파일은 채워지지 않습니다.

copyRequiresWriterPermission

boolean

리더 및 댓글 작성자가 이 파일의 복사, 인쇄, 다운로드 옵션을 사용 중지할지 선택합니다.

permissions[]

object (Permission)

출력 전용입니다. 이 파일에 액세스할 수 있는 사용자의 권한 목록입니다. 공유 드라이브 내 항목에는 채워지지 않습니다.

hasThumbnail

boolean

출력 전용입니다. 파일에 썸네일이 있는지 여부입니다. 요청하는 앱이 썸네일에 액세스할 수 있는지는 나타내지 않습니다. 액세스 권한을 확인하려면 썸네일 링크 필드가 있는지 확인하세요.

spaces[]

string

출력 전용입니다. 파일이 포함된 스페이스 목록입니다. 지원되는 값은 drive, appDataFolder, photos입니다.

folderColorRgb

string

파일이 폴더 또는 폴더의 바로가기인 경우 RGB 16진수 문자열로 표시되는 폴더 색상입니다. 지원되는 색상 목록은 정보 리소스의 folderColorPalette 필드에서 확인할 수 있습니다. 지원되지 않는 색상을 지정하면 팔레트에서 가장 가까운 색상으로 변경됩니다.

id

string

파일의 ID입니다.

title

string

이 파일의 제목입니다. 공유 드라이브의 최상위 폴더, 내 드라이브 루트 폴더, 애플리케이션 데이터 폴더와 같이 변경할 수 없는 항목의 경우 제목이 동일하게 유지됩니다.

description

string

파일에 관한 간단한 설명입니다.

labels

object

파일의 라벨 그룹입니다.

labels.viewed

boolean

이 사용자가 파일을 보았는지 여부입니다.

labels.restricted
(deprecated)

boolean

출력 전용입니다. 지원 중단됨: 대신 copyRequiresWriterPermission를 사용하세요.

labels.starred

boolean

사용자가 이 파일을 별표표시했는지 여부입니다.

labels.hidden
(deprecated)

boolean

출력 전용입니다. 지원 중단되었습니다.

labels.trashed

boolean

파일이 휴지통으로 이동되었는지 여부입니다. 이 라벨은 파일에 액세스하는 모든 사용자에게 적용됩니다. 소유자만 파일을 보고 삭제할 수 있습니다.

labels.modified

boolean

출력 전용입니다. 이 사용자가 파일을 수정했는지 여부입니다.

explicitlyTrashed

boolean

출력 전용입니다. 이 파일이 반복적으로 휴지통으로 이동되지 않고 명시적으로 휴지통으로 이동되었는지 여부를 나타냅니다.

createdDate

string

출력 전용입니다. 이 파일의 생성 시간입니다 (RFC 3339 타임스탬프 형식).

modifiedDate

string

다른 사용자가 이 파일을 마지막으로 수정한 시간입니다 (RFC 3339 타임스탬프 형식). setModifiedDate 매개변수가 설정된 경우 업데이트 시에만 변경 가능합니다.

modifiedByMeDate

string

출력 전용입니다. 사용자가 이 파일을 마지막으로 수정한 시간입니다 (RFC 3339 타임스탬프 형식). FixedDate를 설정하면 날짜를 설정한 사용자의ModifiedByMe 날짜도 업데이트됩니다.

lastViewedByMeDate

string

사용자가 이 파일을 마지막으로 본 시간입니다 (RFC 3339 타임스탬프 형식).

markedViewedByMeDate
(deprecated)

string

출력 전용입니다. 지원 중단되었습니다.

sharedWithMeDate

string

출력 전용입니다. 이 파일이 사용자와 공유된 시간입니다 (RFC 3339 타임스탬프 형식).

quotaBytesUsed

string (int64 format)

출력 전용입니다. 이 파일에서 사용하는 할당량 바이트 수입니다.

version

string (int64 format)

출력 전용입니다. 단조 증가하는 파일 버전 번호입니다. 여기에는 요청하는 사용자에게 보이지 않는 변경 사항을 포함하여 서버의 파일에 대한 모든 변경사항이 반영됩니다.

indexableText

object

파일의 색인 생성 가능한 텍스트 속성 (쓰기만 가능)

indexableText.text

string

이 파일의 색인을 생성할 텍스트입니다.

originalFilename

string

가능한 경우 업로드된 콘텐츠의 원래 파일 이름이거나 title 필드의 원래 값입니다. Google Drive에 바이너리 콘텐츠가 있는 파일에만 사용할 수 있습니다.

ownedByMe

boolean

출력 전용입니다. 파일을 현재 사용자가 소유하고 있는지 여부입니다. 공유 드라이브 내 항목에는 채워지지 않습니다.

canComment
(deprecated)

boolean

출력 전용입니다. 지원 중단됨: 대신 capabilities/canComment를 사용하세요.

shareable
(deprecated)

boolean

출력 전용입니다. 지원 중단됨: 대신 capabilities/canShare를 사용하세요.

fullFileExtension

string

출력 전용입니다. 전체 파일 확장자 제목에서 추출했습니다. 'tar.gz'와 같이 연결된 확장자가 여러 개 포함될 수 있습니다. 제목에서 확장 프로그램을 삭제해도 이 필드는 지워지지 않습니다. 제목의 확장자를 변경하면 이 필드가 업데이트됩니다. 이 필드는 Google Drive에 저장된 콘텐츠가 있는 파일에 대해서만 채워집니다. Docs 편집기 또는 바로가기 파일의 경우 채워지지 않습니다.

isAppAuthorized

boolean

출력 전용입니다. 요청 앱에서 파일을 만들었는지 또는 열었는지 여부입니다.

teamDriveId
(deprecated)

string

출력 전용입니다. 지원 중단됨: 대신 driveId를 사용하세요.

capabilities

object

출력 전용입니다. 현재 사용자가 이 파일에서 사용할 수 있는 기능입니다. 각 기능은 사용자가 취할 수 있는 세분화된 작업에 해당합니다.

capabilities.canChangeRestrictedDownload
(deprecated)

boolean

출력 전용입니다. 지원 중단되었습니다.

capabilities.canMoveChildrenOutOfDrive

boolean

출력 전용입니다. 현재 사용자가 이 폴더의 하위 항목을 공유 드라이브 외부로 이동할 수 있는지 여부입니다. 항목이 폴더가 아닌 경우 false입니다. 공유 드라이브의 항목에만 채워집니다.

capabilities.canReadDrive

boolean

출력 전용입니다. 현재 사용자가 이 파일이 속한 공유 드라이브를 읽을 수 있는지 여부입니다. 공유 드라이브의 항목에만 채워집니다.

capabilities.canEdit

boolean

출력 전용입니다. 현재 사용자가 이 파일을 수정할 수 있는지 여부입니다. 다른 요인으로 인해 사용자가 파일을 변경할 수 있는 유형이 제한될 수 있습니다. 예를 들어 canChangeCopyRequiresWriterPermission 또는 canModifyContent를 참고하세요.

capabilities.canCopy

boolean

출력 전용입니다. 현재 사용자가 이 파일을 복사할 수 있는지 여부입니다. 공유 드라이브 내 항목의 경우 현재 사용자가 이 항목의 폴더가 아닌 하위 항목을 복사할 수 있는지 또는 폴더가 아닌 경우 이 항목 자체를 복사할 수 있는지 여부입니다.

capabilities.canComment

boolean

출력 전용입니다. 현재 사용자가 이 파일에 댓글을 쓸 수 있는지 여부입니다.

capabilities.canAddChildren

boolean

출력 전용입니다. 현재 사용자가 이 폴더에 하위 항목을 추가할 수 있는지 여부입니다. 항목이 폴더가 아닌 경우 항상 false입니다.

capabilities.canDelete

boolean

출력 전용입니다. 현재 사용자가 이 파일을 삭제할 수 있는지 여부입니다.

capabilities.canDownload

boolean

출력 전용입니다. 현재 사용자가 이 파일을 다운로드할 수 있는지 여부입니다.

capabilities.canListChildren

boolean

출력 전용입니다. 현재 사용자가 이 폴더의 하위 항목을 나열할 수 있는지 여부입니다. 항목이 폴더가 아닌 경우 항상 false입니다.

capabilities.canRemoveChildren

boolean

출력 전용입니다. 현재 사용자가 이 폴더에서 하위 항목을 삭제할 수 있는지 여부입니다. 항목이 폴더가 아닌 경우 항상 false입니다. 공유 드라이브의 폴더의 경우 canDeleteChildren 또는 canTrashChildren를 대신 사용하세요.

capabilities.canRename

boolean

출력 전용입니다. 현재 사용자가 이 파일의 이름을 변경할 수 있는지 여부입니다.

capabilities.canTrash

boolean

출력 전용입니다. 현재 사용자가 이 파일을 휴지통으로 이동할 수 있는지 여부입니다.

capabilities.canReadRevisions

boolean

출력 전용입니다. 현재 사용자가 이 파일의 버전 리소스를 읽을 수 있는지 여부입니다. 공유 드라이브 항목의 경우 이 항목의 폴더가 아닌 하위 항목 버전 또는 폴더가 아닌 경우 이 항목 자체의 버전을 읽을 수 있습니다.

capabilities.canReadTeamDrive
(deprecated)

boolean

출력 전용입니다. 지원 중단됨: 대신 canReadDrive를 사용하세요.

capabilities.canMoveTeamDriveItem
(deprecated)

boolean

출력 전용입니다. 지원 중단됨: 대신 canMoveItemWithinDrive 또는 canMoveItemOutOfDrive를 사용하세요.

capabilities.canChangeCopyRequiresWriterPermission

boolean

출력 전용입니다. 현재 사용자가 이 파일의 copyRequiresWriterPermission 제한사항을 변경할 수 있는지 여부입니다.

capabilities.canMoveItemIntoTeamDrive
(deprecated)

boolean

출력 전용입니다. 지원 중단됨: 대신 canMoveItemOutOfDrive를 사용하세요.

capabilities.canUntrash

boolean

출력 전용입니다. 현재 사용자가 이 파일을 휴지통에서 복원할 수 있는지 여부입니다.

capabilities.canModifyContent

boolean

출력 전용입니다. 현재 사용자가 이 파일의 콘텐츠를 수정할 수 있는지 여부입니다.

capabilities.canMoveItemWithinTeamDrive
(deprecated)

boolean

출력 전용입니다. 지원 중단됨: 대신 canMoveItemWithinDrive를 사용하세요.

capabilities.canMoveItemOutOfTeamDrive
(deprecated)

boolean

출력 전용입니다. 지원 중단됨: 대신 canMoveItemOutOfDrive를 사용하세요.

capabilities.canDeleteChildren

boolean

출력 전용입니다. 현재 사용자가 이 폴더의 하위 항목을 삭제할 수 있는지 여부입니다. 항목이 폴더가 아닌 경우 false입니다. 공유 드라이브의 항목에만 채워집니다.

capabilities.canMoveChildrenOutOfTeamDrive
(deprecated)

boolean

출력 전용입니다. 지원 중단됨: 대신 canMoveChildrenOutOfDrive를 사용하세요.

capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

출력 전용입니다. 지원 중단됨: 대신 canMoveChildrenWithinDrive를 사용하세요.

capabilities.canTrashChildren

boolean

출력 전용입니다. 현재 사용자가 이 폴더의 하위 항목을 휴지통으로 이동할 수 있는지 여부입니다. 항목이 폴더가 아닌 경우 false입니다. 공유 드라이브의 항목에만 채워집니다.

capabilities.canMoveItemOutOfDrive

boolean

출력 전용입니다. 현재 사용자가 상위 항목을 변경하여 항목을 이 드라이브 외부로 이동할 수 있는지를 나타냅니다. 추가되는 새로운 상위 항목에 따라 항목의 상위 항목을 변경해 달라는 요청이 여전히 실패할 수 있습니다.

capabilities.canAddMyDriveParent

boolean

출력 전용입니다. 현재 사용자가 동일한 요청에서 기존 상위 항목을 삭제하지 않고도 항목의 상위 항목을 추가할 수 있는지 여부입니다. 공유 드라이브 파일에는 채워지지 않습니다.

capabilities.canRemoveMyDriveParent

boolean

출력 전용입니다. 현재 사용자가 동일한 요청에서 다른 상위 요소를 추가하지 않고도 항목에서 상위 항목을 삭제할 수 있는지 여부입니다. 공유 드라이브 파일에는 채워지지 않습니다.

capabilities.canMoveItemWithinDrive

boolean

출력 전용입니다. 현재 사용자가 이 드라이브 내에서 이 항목을 이동할 수 있는지 여부입니다. 추가되는 새로운 상위 요소와 삭제되는 상위 항목에 따라 항목의 상위 항목을 변경해 달라는 요청이 여전히 실패할 수 있습니다.

capabilities.canShare

boolean

출력 전용입니다. 현재 사용자가 이 파일의 공유 설정을 수정할 수 있는지 여부입니다.

capabilities.canMoveChildrenWithinDrive

boolean

출력 전용입니다. 현재 사용자가 이 드라이브 내에서 이 폴더의 하위 항목을 이동할 수 있는지 여부입니다. 항목이 폴더가 아닌 경우 false입니다. 하위 항목과 대상 폴더에 대한 현재 사용자의 액세스 권한에 따라 하위 항목 이동 요청이 여전히 실패할 수도 있습니다.

capabilities.canModifyContentRestriction
(deprecated)

boolean

지원 중단됨: 출력 전용. canModifyEditorContentRestriction, canModifyOwnerContentRestriction, canRemoveContentRestriction 중 하나를 사용하세요.

capabilities.canAddFolderFromAnotherDrive

boolean

출력 전용입니다. 현재 사용자가 다른 드라이브 (다른 공유 드라이브 또는 내 드라이브)의 폴더를 이 폴더에 추가할 수 있는지 여부입니다. 항목이 폴더가 아닌 경우 false입니다. 공유 드라이브의 항목에만 채워집니다.

capabilities.canChangeSecurityUpdateEnabled

boolean

출력 전용입니다. 현재 사용자가 링크 공유 메타데이터의 securityUpdateEnabled 필드를 변경할 수 있는지 여부입니다.

capabilities.canAcceptOwnership

boolean

출력 전용입니다. 현재 사용자가 대기 중인 파일 소유자인지 여부입니다. 공유 드라이브 파일에는 채워지지 않습니다.

capabilities.canReadLabels

boolean

출력 전용입니다. 현재 사용자가 파일의 라벨을 읽을 수 있는지 여부입니다.

capabilities.canModifyLabels

boolean

출력 전용입니다. 현재 사용자가 파일의 라벨을 수정할 수 있는지 여부입니다.

capabilities.canModifyEditorContentRestriction

boolean

출력 전용입니다. 현재 사용자가 편집자가 제한된 파일에서 콘텐츠 제한을 추가하거나 수정할 수 있는지 여부입니다.

capabilities.canModifyOwnerContentRestriction

boolean

출력 전용입니다. 현재 사용자가 소유자가 제한된 콘텐츠 제한을 추가하거나 수정할 수 있는지 여부입니다.

capabilities.canRemoveContentRestriction

boolean

출력 전용입니다. 현재 사용자가 삭제할 수 있는 파일의 콘텐츠 제한이 있는지 여부

hasAugmentedPermissions

boolean

출력 전용입니다. 이 파일에 대한 직접 권한이 있는지 여부입니다. 이 필드는 공유 드라이브의 항목에 대해서만 채워집니다.

trashingUser

object (User)

출력 전용입니다. 파일이 명시적으로 휴지통으로 이동된 경우 해당 파일을 휴지통으로 이동한 사용자입니다. 공유 드라이브의 항목에만 채워집니다.

canReadRevisions
(deprecated)

boolean

출력 전용입니다. 지원 중단됨: 대신 capabilities/canReadRevisions를 사용하세요.

thumbnailVersion

string (int64 format)

출력 전용입니다. 썸네일 캐시 무효화에 사용할 썸네일 버전입니다.

trashedDate

string

출력 전용입니다. 항목이 휴지통으로 이동된 시간입니다 (RFC 3339 타임스탬프 형식). 공유 드라이브의 항목에만 채워집니다.

permissionIds[]

string

출력 전용. 파일 액세스 권한이 있는 사용자에 대한 권한 ID의 files.list입니다.

thumbnail

object

파일의 썸네일입니다. 표준 썸네일을 생성할 수 없는 경우에만 사용됩니다.

thumbnail.image

string (bytes format)

썸네일 이미지의 URL 보안 Base64 인코딩 바이트입니다. RFC 4648 5조를 준수해야 합니다.

base64 인코딩 문자열입니다.

thumbnail.mimeType

string

썸네일의 MIME 유형입니다.

imageMediaMetadata

object

출력 전용입니다. 이미지 미디어에 대한 메타데이터입니다. 이는 이미지 유형에만 표시되며 콘텐츠는 이미지 콘텐츠에서 파싱할 수 있는 항목에 따라 다릅니다.

imageMediaMetadata.flashUsed

boolean

출력 전용입니다. 사진을 만드는 데 플래시를 사용했는지 여부입니다.

imageMediaMetadata.meteringMode

string

출력 전용입니다. 사진을 만드는 데 사용된 측광 모드입니다.

imageMediaMetadata.sensor

string

출력 전용입니다. 사진을 만드는 데 사용된 센서 유형입니다.

imageMediaMetadata.exposureMode

string

출력 전용입니다. 사진을 만드는 데 사용된 노출 모드입니다.

imageMediaMetadata.colorSpace

string

출력 전용입니다. 사진의 색상 공간입니다.

imageMediaMetadata.whiteBalance

string

출력 전용입니다. 사진을 만드는 데 사용된 화이트 밸런스 모드입니다.

imageMediaMetadata.width

integer

출력 전용입니다. 이미지 너비(픽셀 단위)입니다.

imageMediaMetadata.height

integer

출력 전용입니다. 이미지 높이(픽셀 단위)입니다.

imageMediaMetadata.location

object

출력 전용입니다. 이미지에 저장된 지리적 위치 정보입니다.

imageMediaMetadata.location.latitude

number

출력 전용입니다. 이미지에 저장된 위도입니다.

imageMediaMetadata.location.longitude

number

출력 전용입니다. 이미지에 저장된 경도입니다.

imageMediaMetadata.location.altitude

number

출력 전용입니다. 이미지에 저장된 고도입니다.

imageMediaMetadata.rotation

integer

출력 전용입니다. 이미지의 원래 방향에서 적용된 시계 방향 90도 회전 횟수입니다.

imageMediaMetadata.date

string

출력 전용입니다. 사진을 찍은 날짜 및 시간 (EXIF 형식 타임스탬프)

imageMediaMetadata.cameraMake

string

출력 전용입니다. 사진을 만드는 데 사용된 카메라의 제조업체입니다.

imageMediaMetadata.cameraModel

string

출력 전용입니다. 사진을 만드는 데 사용된 카메라 모델입니다.

imageMediaMetadata.exposureTime

number

출력 전용입니다. 노출 길이(초)입니다.

imageMediaMetadata.aperture

number

출력 전용입니다. 사진을 만드는 데 사용된 조리개 (f-number)입니다.

imageMediaMetadata.focalLength

number

출력 전용입니다. 사진을 만드는 데 사용된 초점 거리(밀리미터)입니다.

imageMediaMetadata.isoSpeed

integer

출력 전용입니다. 사진을 만드는 데 사용된 ISO 속도입니다.

imageMediaMetadata.exposureBias

number

출력 전용입니다. 사진의 노출 바이어스입니다 (APEX 값).

imageMediaMetadata.maxApertureValue

number

출력 전용입니다. 사진을 만드는 데 사용된 초점 거리에서 렌즈의 최소 f-number (APEX 값)입니다.

imageMediaMetadata.subjectDistance

integer

출력 전용입니다. 사진 피사체까지의 거리(미터)입니다.

imageMediaMetadata.lens

string

출력 전용입니다. 사진을 만드는 데 사용된 렌즈입니다.

videoMediaMetadata

object

출력 전용입니다. 동영상 미디어에 대한 메타데이터입니다. 동영상 유형에만 표시됩니다.

videoMediaMetadata.width

integer

출력 전용입니다. 동영상의 너비입니다(단위: 픽셀).

videoMediaMetadata.height

integer

출력 전용입니다. 동영상의 높이(픽셀)입니다.

videoMediaMetadata.durationMillis

string (int64 format)

출력 전용입니다. 동영상 재생 시간(밀리초)입니다.

shortcutDetails

object

바로가기 파일 세부정보입니다. mimeType 필드가 application/vnd.google-apps.shortcut로 설정된 바로가기 파일에만 채워집니다. files.insert 요청에서만 설정할 수 있습니다.

shortcutDetails.targetId

string

이 바로가기가 가리키는 파일의 ID입니다. files.insert 요청에서만 설정할 수 있습니다.

shortcutDetails.targetMimeType

string

출력 전용입니다. 이 단축키가 가리키는 파일의 MIME 유형입니다. 이 필드의 값은 바로가기가 생성될 때 캡처된 대상의 MIME 유형의 스냅샷입니다.

shortcutDetails.targetResourceKey

string

출력 전용입니다. 대상 파일의 ResourceKey

contentRestrictions[]

object (ContentRestriction)

파일 콘텐츠 액세스 제한 이러한 제한이 있는 경우에만 채워집니다.

resourceKey

string

출력 전용입니다. 공유 링크를 통해 항목에 액세스하려면 키가 필요합니다.

linkShareMetadata.securityUpdateEligible

boolean

출력 전용입니다. 파일이 보안 업데이트 대상인지 여부입니다.

linkShareMetadata.securityUpdateEnabled

boolean

출력 전용입니다. 이 파일에 보안 업데이트가 사용 설정되어 있는지 여부입니다.

labelInfo

object

출력 전용입니다. 파일의 라벨 개요입니다.

labelInfo.labels[]

object (Label)

출력 전용입니다. includeLabels 매개변수의 라벨 ID에서 요청한 파일의 라벨 집합입니다. 기본적으로 라벨은 반환되지 않습니다.

sha1Checksum

string

출력 전용입니다. 이 파일과 연결된 SHA1 체크섬입니다(사용 가능한 경우). 이 필드는 Google Drive에 저장된 콘텐츠가 있는 파일에 대해서만 채워집니다. Docs 편집기 또는 바로가기 파일의 경우 채워지지 않습니다.

sha256Checksum

string

출력 전용입니다. 이 파일과 연결된 SHA256 체크섬입니다(있는 경우). 이 필드는 Google Drive에 저장된 콘텐츠가 있는 파일에 대해서만 채워집니다. Docs 편집기 또는 바로가기 파일의 경우 채워지지 않습니다.

ContentRestriction

파일 콘텐츠에 대한 액세스 제한.

JSON 표현
{
  "readOnly": boolean,
  "reason": string,
  "type": string,
  "restrictingUser": {
    object (User)
  },
  "restrictionDate": string,
  "ownerRestricted": boolean,
  "systemRestricted": boolean
}
필드
readOnly

boolean

파일의 콘텐츠가 읽기 전용인지 여부입니다. 읽기 전용 파일의 경우 파일의 새 버전이 추가되지 않고 댓글이 추가되거나 수정되지 않으며 파일 제목이 수정되지 않을 수도 있습니다.

reason

string

파일의 콘텐츠가 제한된 이유입니다. readOnly=true도 설정하는 요청에서만 변경 가능합니다.

type

string

출력 전용입니다. 콘텐츠 제한의 유형입니다. 현재 가능한 유일한 값은 globalContentRestriction입니다.

restrictingUser

object (User)

출력 전용입니다. 콘텐츠 제한을 설정한 사용자입니다. readOnly가 true인 경우에만 채워집니다.

restrictionDate

string

출력 전용입니다. 콘텐츠 제한이 설정된 시간입니다 (RFC 3339 타임스탬프 형식). readOnly가 true인 경우에만 채워집니다.

ownerRestricted

boolean

파일을 소유한 사용자만 콘텐츠 제한을 수정하거나 삭제할 수 있는지 여부입니다. 공유 드라이브 파일의 경우 organizer 권한이 있는 모든 사용자가 이 콘텐츠 제한을 수정하거나 삭제할 수 있습니다.

systemRestricted

boolean

출력 전용입니다. 전자 서명으로 인해 시스템에서 콘텐츠 제한을 적용했는지 여부입니다. 사용자는 시스템 제한 콘텐츠 제한을 수정하거나 삭제할 수 없습니다.

메서드

copy

지정된 파일의 사본을 만듭니다.

delete

사용자가 소유한 파일을 휴지통으로 이동하지 않고 완전히 삭제합니다.

emptyTrash

사용자의 휴지통으로 이동한 파일을 모두 완전히 삭제합니다.

export

Google Workspace 문서를 요청된 MIME 유형으로 내보내고 내보낸 바이트 콘텐츠를 반환합니다.

generateIds

삽입 또는 복사 요청에 제공할 수 있는 파일 ID 집합을 생성합니다.

get

ID로 파일의 메타데이터 또는 콘텐츠를 가져옵니다.

insert

새 파일을 삽입합니다.

list

사용자의 파일을 나열합니다.

listLabels

파일의 라벨을 나열합니다.

modifyLabels

파일에 적용된 라벨 집합을 수정합니다.

patch

파일의 메타데이터 및/또는 콘텐츠를 업데이트합니다.

touch

파일의 업데이트된 시간을 현재 서버 시간으로 설정합니다.

trash

파일을 휴지통으로 이동합니다.

untrash

휴지통에서 파일을 복원합니다.

update

파일의 메타데이터 및/또는 콘텐츠를 업데이트합니다.

watch

파일 변경사항을 구독합니다.