Files

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

이 리소스에 대한 메소드 목록은 이 페이지의 하단에 나와 있습니다.

리소스 표현

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

{
  "kind": "drive#file",
  "id": string,
  "name": string,
  "mimeType": string,
  "description": string,
  "starred": boolean,
  "trashed": boolean,
  "explicitlyTrashed": boolean,
  "trashingUser": {
    "kind": "drive#user",
    "displayName": string,
    "photoLink": string,
    "me": boolean,
    "permissionId": string,
    "emailAddress": string
  },
  "trashedTime": datetime,
  "parents": [
    string
  ],
  "properties": {
    (key): string
  },
  "appProperties": {
    (key): string
  },
  "spaces": [
    string
  ],
  "version": long,
  "webContentLink": string,
  "webViewLink": string,
  "iconLink": string,
  "hasThumbnail": boolean,
  "thumbnailLink": string,
  "thumbnailVersion": long,
  "viewedByMe": boolean,
  "viewedByMeTime": datetime,
  "createdTime": datetime,
  "modifiedTime": datetime,
  "modifiedByMeTime": datetime,
  "modifiedByMe": boolean,
  "sharedWithMeTime": datetime,
  "sharingUser": {
    "kind": "drive#user",
    "displayName": string,
    "photoLink": string,
    "me": boolean,
    "permissionId": string,
    "emailAddress": string
  },
  "owners": [
    {
      "kind": "drive#user",
      "displayName": string,
      "photoLink": string,
      "me": boolean,
      "permissionId": string,
      "emailAddress": string
    }
  ],
  "teamDriveId": string,
  "driveId": string,
  "lastModifyingUser": {
    "kind": "drive#user",
    "displayName": string,
    "photoLink": string,
    "me": boolean,
    "permissionId": string,
    "emailAddress": string
  },
  "shared": boolean,
  "ownedByMe": boolean,
  "capabilities": {
    "canAcceptOwnership": boolean,
    "canAddChildren": boolean,
    "canAddFolderFromAnotherDrive": boolean,
    "canAddMyDriveParent": boolean,
    "canChangeCopyRequiresWriterPermission": boolean,
    "canChangeSecurityUpdateEnabled": boolean,
    "canChangeViewersCanCopyContent": boolean,
    "canComment": boolean,
    "canCopy": boolean,
    "canDelete": boolean,
    "canDeleteChildren": boolean,
    "canDownload": boolean,
    "canEdit": boolean,
    "canListChildren": boolean,
    "canModifyContent": boolean,
    "canModifyContentRestriction": boolean,
    "canModifyLabels": boolean,
    "canMoveChildrenOutOfTeamDrive": boolean,
    "canMoveChildrenOutOfDrive": boolean,
    "canMoveChildrenWithinTeamDrive": boolean,
    "canMoveChildrenWithinDrive": boolean,
    "canMoveItemIntoTeamDrive": boolean,
    "canMoveItemOutOfTeamDrive": boolean,
    "canMoveItemOutOfDrive": boolean,
    "canMoveItemWithinTeamDrive": boolean,
    "canMoveItemWithinDrive": boolean,
    "canMoveTeamDriveItem": boolean,
    "canReadLabels": boolean,
    "canReadRevisions": boolean,
    "canReadTeamDrive": boolean,
    "canReadDrive": boolean,
    "canRemoveChildren": boolean,
    "canRemoveMyDriveParent": boolean,
    "canRename": boolean,
    "canShare": boolean,
    "canTrash": boolean,
    "canTrashChildren": boolean,
    "canUntrash": boolean
  },
  "viewersCanCopyContent": boolean,
  "copyRequiresWriterPermission": boolean,
  "writersCanShare": boolean,
  "permissions": [
    permissions Resource
  ],
  "permissionIds": [
    string
  ],
  "hasAugmentedPermissions": boolean,
  "folderColorRgb": string,
  "originalFilename": string,
  "fullFileExtension": string,
  "fileExtension": string,
  "md5Checksum": string,
  "sha1Checksum": string,
  "sha256Checksum": string,
  "size": long,
  "quotaBytesUsed": long,
  "headRevisionId": string,
  "contentHints": {
    "thumbnail": {
      "image": bytes,
      "mimeType": string
    },
    "indexableText": string
  },
  "imageMediaMetadata": {
    "width": integer,
    "height": integer,
    "rotation": integer,
    "location": {
      "latitude": double,
      "longitude": double,
      "altitude": double
    },
    "time": string,
    "cameraMake": string,
    "cameraModel": string,
    "exposureTime": float,
    "aperture": float,
    "flashUsed": boolean,
    "focalLength": float,
    "isoSpeed": integer,
    "meteringMode": string,
    "sensor": string,
    "exposureMode": string,
    "colorSpace": string,
    "whiteBalance": string,
    "exposureBias": float,
    "maxApertureValue": float,
    "subjectDistance": integer,
    "lens": string
  },
  "videoMediaMetadata": {
    "width": integer,
    "height": integer,
    "durationMillis": long
  },
  "isAppAuthorized": boolean,
  "exportLinks": {
    (key): string
  },
  "shortcutDetails": {
    "targetId": string,
    "targetMimeType": string,
    "targetResourceKey": string
  },
  "contentRestrictions": [
    {
      "readOnly": boolean,
      "reason": string,
      "restrictingUser": {
        "kind": "drive#user",
        "displayName": string,
        "photoLink": string,
        "me": boolean,
        "permissionId": string,
        "emailAddress": string
      },
      "restrictionTime": datetime,
      "type": string
    }
  ],
  "labelInfo": {
    "labels": [
      {
        "kind": "drive#label",
        "id": string,
        "revisionId": string,
        "fields": {
          (key): {
            "kind": "drive#labelField",
            "id": string,
            "valueType": string,
            "dateString": [
              date
            ],
            "integer": [
              long
            ],
            "selection": [
              string
            ],
            "text": [
              string
            ],
            "user": [
              {
                "kind": "drive#user",
                "displayName": string,
                "photoLink": string,
                "me": boolean,
                "permissionId": string,
                "emailAddress": string
              }
            ]
          }
        }
      }
    ]
  },
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  }
}
숙소 이름 설명 메모
kind string 리소스 종류를 식별합니다. 값: 고정 문자열 "drive#file".
id string 파일의 ID입니다. 쓰기 가능
name string 파일 이름입니다. 폴더 내에서 고유하지 않을 수도 있습니다. 공유 드라이브의 최상위 폴더, 내 드라이브 루트 폴더, 애플리케이션 데이터 폴더와 같이 변경할 수 없는 항목의 이름은 동일합니다. 쓰기 가능
mimeType string 파일의 MIME 유형입니다.

값이 없으면 Google Drive에서 업로드된 콘텐츠에서 적절한 값을 자동으로 감지합니다. 새 버전이 업로드되지 않는 한 이 값은 변경할 수 없습니다.

Google 문서 MIME 유형으로 파일이 생성된 경우 가능하면 업로드된 콘텐츠를 가져옵니다. 지원되는 가져오기 형식은 정보 리소스에 게시됩니다.

쓰기 가능
description string 파일에 관한 간단한 설명입니다. 쓰기 가능
starred boolean 사용자가 파일에 별표표시했는지 여부 쓰기 가능
trashed boolean 파일이 휴지통에서 휴지통으로 이동되었는지 또는 휴지통 상위 폴더에서 휴지통으로 이동되었는지 여부 소유자만 파일을 휴지통으로 이동할 수 있습니다. 휴지통에서는 파일을 소유하지 않은 모든 사용자에 대해 반환된 모든 files.list 응답에서 제외됩니다. 하지만 파일에 액세스할 수 있는 모든 사용자는 API 응답에서 휴지통 항목 메타데이터를 볼 수 있습니다. 액세스 권한이 있는 모든 사용자는 파일을 복사, 다운로드, 내보내기, 공유할 수 있습니다. 쓰기 가능
explicitlyTrashed boolean 파일이 상위 폴더에서 반복적으로 휴지통으로 이동하지 않고 명시적으로 휴지통에 버렸는지 여부
parents[] list 파일이 포함된 상위 폴더의 ID입니다.

만들기 요청의 일부로 지정되지 않은 경우 파일은 사용자의 내 드라이브 폴더에 직접 저장됩니다. 복사 요청의 일부로 지정되지 않은 경우 파일은 소스 파일의 검색 가능한 상위 요소를 상속합니다. 업데이트 요청은 addParentsremoveParents 매개변수를 사용하여 상위 목록을 수정해야 합니다.

쓰기 가능
properties object 모든 앱에 표시되는 임의의 키-값 쌍 모음입니다.

null 값이 있는 항목은 업데이트 및 복사 요청에서 지워집니다.

쓰기 가능
properties.(key) string
appProperties object 요청하는 앱에만 해당하는 임의의 키-값 쌍 모음입니다.

null 값이 있는 항목은 업데이트 및 복사 요청에서 지워집니다. 이러한 속성은 인증된 요청을 사용해서만 가져올 수 있습니다. 인증된 요청은 OAuth 2 클라이언트 ID로 받은 액세스 토큰을 사용합니다. API 키를 사용하여 비공개 속성을 가져올 수 없습니다.

쓰기 가능
appProperties.(key) string
spaces[] list 파일이 포함된 스페이스의 목록 현재 지원되는 값은 'drive', 'appDataFolder', 'photos'입니다.
version long 파일의 단조롭게 증가하는 버전 번호입니다. 여기에는 서버에서 파일의 모든 변경사항이 반영됩니다(사용자에게 표시되지 않음 포함).
viewedByMe boolean 사용자가 이 파일을 봤는지 여부
viewedByMeTime datetime 사용자가 파일을 마지막으로 본 시간 (RFC 3339 날짜-시간). 쓰기 가능
createdTime datetime 파일이 생성된 시간입니다 (RFC 3339 날짜-시간). 쓰기 가능
modifiedTime datetime 사용자가 마지막으로 파일을 수정한 시간 (RFC 3339 날짜-시간).

modifiedTime을 설정하면 사용자의 modifiedByMeTime도 업데이트됩니다.

쓰기 가능
modifiedByMeTime datetime 사용자가 파일을 마지막으로 수정한 시간 (RFC 3339 날짜-시간).
sharedWithMeTime datetime 파일이 사용자와 공유된 시간(해당하는 경우)입니다(RFC 3339 날짜-시간).
sharingUser nested object 요청하는 사용자와 파일을 공유한 사용자입니다(해당하는 경우).
sharingUser.kind string 리소스 종류를 식별합니다. 값: 고정 문자열 "drive#user".
sharingUser.displayName string 이 사용자의 표시 가능한 일반 텍스트 이름입니다.
sharingUser.me boolean 이 사용자가 요청 사용자인지 여부입니다.
sharingUser.permissionId string 권한 리소스에 표시되는 사용자 ID입니다.
sharingUser.emailAddress string 사용자의 이메일 주소입니다. 사용자가 이메일 주소를 요청자에게 표시하지 않은 경우에는 특정 컨텍스트에서 표시되지 않을 수 있습니다.
owners[] list 이 파일의 소유자입니다. 특정 기존 파일에만 소유자가 두 명 이상 있을 수 있습니다. 이 필드는 공유 드라이브의 항목에 입력되지 않습니다.
owners[].kind string 리소스 종류를 식별합니다. 값: 고정 문자열 "drive#user".
owners[].displayName string 이 사용자의 표시 가능한 일반 텍스트 이름입니다.
owners[].me boolean 이 사용자가 요청 사용자인지 여부입니다.
owners[].permissionId string 권한 리소스에 표시되는 사용자 ID입니다.
owners[].emailAddress string 사용자의 이메일 주소입니다. 사용자가 이메일 주소를 요청자에게 표시하지 않은 경우에는 특정 컨텍스트에서 표시되지 않을 수 있습니다.
lastModifyingUser nested object 파일을 수정한 마지막 사용자
lastModifyingUser.kind string 리소스 종류를 식별합니다. 값: 고정 문자열 "drive#user".
lastModifyingUser.displayName string 이 사용자의 표시 가능한 일반 텍스트 이름입니다.
lastModifyingUser.me boolean 이 사용자가 요청 사용자인지 여부입니다.
lastModifyingUser.permissionId string 권한 리소스에 표시되는 사용자 ID입니다.
lastModifyingUser.emailAddress string 사용자의 이메일 주소입니다. 사용자가 이메일 주소를 요청자에게 표시하지 않은 경우에는 특정 컨텍스트에서 표시되지 않을 수 있습니다.
shared boolean 파일 공유 여부 공유 드라이브 항목의 항목이 채워지지 않았습니다.
ownedByMe boolean 사용자의 파일 소유 여부 공유 드라이브 항목의 항목이 채워지지 않았습니다.
viewersCanCopyContent boolean copyRequiresWriterPermission를 대신 사용하세요.
writersCanShare boolean writer 권한만 있는 사용자가 파일의 권한을 수정할 수 있는지 여부 공유 드라이브 항목의 항목이 채워지지 않았습니다. 쓰기 가능
permissions[] list 파일의 전체 권한 목록입니다. 이 옵션은 요청하는 사용자가 파일을 공유할 수 있는 경우에만 사용할 수 있습니다. 공유 드라이브 항목의 항목이 채워지지 않았습니다.
folderColorRgb string RGB 16진수 문자열로 폴더 또는 폴더 바로가기의 색상입니다. 지원되는 색상은 정보 리소스의 folderColorPalette 필드에 게시됩니다.

지원되지 않는 색상이 지정되면 팔레트에서 가장 가까운 색상이 대신 사용됩니다.

쓰기 가능
originalFilename string 업로드된 콘텐츠의 원래 파일 이름(있는 경우) 또는 name 필드의 원래 값 이 기능은 Google Drive에 바이너리 콘텐츠가 있는 파일에만 사용할 수 있습니다. 쓰기 가능
fullFileExtension string name 필드에서 추출된 전체 파일 확장자입니다. 'tar.gz'와 같이 여러 개의 연결된 확장자를 포함할 수 있습니다. 이 기능은 Google Drive에 바이너리 콘텐츠가 있는 파일에만 사용할 수 있습니다.

name 필드가 변경되면 자동으로 업데이트되지만 새 이름에 유효한 확장자가 없으면 삭제되지 않습니다.

fileExtension string fullFileExtension의 최종 구성요소입니다. 이 기능은 Google Drive에 바이너리 콘텐츠가 있는 파일에만 사용할 수 있습니다.
md5Checksum string 파일 콘텐츠의 MD5 체크섬입니다. 이는 Google Drive에 바이너리 콘텐츠가 있는 파일에만 적용됩니다.
size long 바이트 단위의 파일 콘텐츠 크기입니다. 이 필드는 바이너리 콘텐츠가 Google Drive에 저장된 파일 및 Docs 편집기 파일에 입력됩니다. 바로가기 또는 폴더에서는 채워지지 않습니다.
quotaBytesUsed long 파일에서 사용하는 스토리지 할당량 바이트 수입니다. 여기에는 keepForever가 사용 설정된 이전 버전과 헤드 버전이 포함됩니다.
headRevisionId string 파일의 헤드 버전 ID입니다. 현재 Google Drive에 바이너리 콘텐츠가 있는 파일에만 사용할 수 있습니다.
contentHints object 파일 콘텐츠에 대한 추가 정보입니다. 이러한 필드는 응답에 채워지지 않습니다.
contentHints.thumbnail object 파일의 썸네일입니다. Google Drive에서 표준 썸네일을 생성할 수 없는 경우에만 사용됩니다.
contentHints.thumbnail.image bytes URL 보안 Base64로 인코딩된 썸네일 데이터 (RFC 4648 섹션 5)입니다. 쓰기 가능
contentHints.thumbnail.mimeType string 썸네일의 MIME 유형입니다. 쓰기 가능
contentHints.indexableText string fullText 쿼리를 개선하기 위해 파일의 색인을 생성할 텍스트입니다. 길이는 128KB로 제한되며 HTML 요소를 포함할 수 있습니다. 자세한 내용은 파일 메타데이터 관리하기를 참고하세요. 쓰기 가능
imageMediaMetadata object 이미지 미디어에 대한 추가 메타데이터(제공되는 경우)
imageMediaMetadata.width integer 이미지 너비(픽셀 단위)입니다.
imageMediaMetadata.height integer 이미지 높이(픽셀 단위)입니다.
imageMediaMetadata.rotation integer 이미지의 원래 방향에서 시계 방향으로 90도 회전한 횟수입니다.
imageMediaMetadata.location object 이미지에 저장된 지리적 위치 정보입니다.
imageMediaMetadata.location.latitude double 이미지에 저장된 위도입니다.
imageMediaMetadata.location.longitude double 이미지에 저장된 경도입니다.
imageMediaMetadata.location.altitude double 이미지에 저장된 고도
imageMediaMetadata.time string 사진을 찍은 날짜 및 시간입니다 (EXIF DateTime).
imageMediaMetadata.cameraMake string 사진 제작에 사용된 카메라 제조업체입니다.
imageMediaMetadata.cameraModel string 사진을 만드는 데 사용된 카메라의 모델입니다.
imageMediaMetadata.exposureTime float 종합 노출 길이(초)
imageMediaMetadata.aperture float 사진 제작에 사용된 조리개 (f-번호)입니다.
imageMediaMetadata.flashUsed boolean 사진을 만드는 데 플래시가 사용되었는지 여부입니다.
imageMediaMetadata.focalLength float 사진을 만드는 데 사용되는 초점 거리(밀리미터)입니다.
imageMediaMetadata.isoSpeed integer 사진을 만들 때 사용되는 ISO 속도입니다.
imageMediaMetadata.meteringMode string 사진을 만드는 데 사용되는 측정 모드입니다.
imageMediaMetadata.sensor string 사진을 만드는 데 사용되는 센서의 유형입니다.
imageMediaMetadata.exposureMode string 사진을 만드는 데 사용되는 노출 모드입니다.
imageMediaMetadata.colorSpace string 사진의 색상 공간입니다.
imageMediaMetadata.whiteBalance string 사진을 만들 때 사용되는 화이트 밸런스 모드입니다.
imageMediaMetadata.exposureBias float 사진의 노출 바이어스 (APEX 값)
imageMediaMetadata.maxApertureValue float 사진을 만드는 데 사용된 초점 거리의 가장 작은 f 숫자입니다 (APEX 값).
imageMediaMetadata.subjectDistance integer 피사체와의 거리입니다(미터 단위).
imageMediaMetadata.lens string 사진을 만드는 데 사용되는 렌즈입니다.
videoMediaMetadata object 동영상 미디어에 대한 추가 메타데이터입니다. 업로드 직후에는 사용하지 못할 수도 있습니다.
videoMediaMetadata.width integer 동영상의 너비(픽셀)입니다.
videoMediaMetadata.height integer 동영상의 높이(픽셀)입니다.
videoMediaMetadata.durationMillis long 동영상의 길이(밀리초)입니다.
capabilities object 이 파일에서 현재 사용자가 가진 기능 각 기능은 사용자가 실행할 수 있는 세분화된 작업에 해당합니다.
capabilities.canEdit boolean 현재 사용자가 이 파일을 수정할 수 있는지 여부입니다. 다른 요인으로 인해 사용자가 파일을 변경할 수 있는 유형이 제한될 수 있습니다. 예를 들어 canChangeCopyRequiresWriterPermission 또는 canModifyContent를 참고하세요.
capabilities.canComment boolean 현재 사용자가 이 파일에 댓글을 쓸 수 있는지 여부입니다.
capabilities.canShare boolean 현재 사용자가 이 파일의 공유 설정을 수정할 수 있는지 여부입니다.
capabilities.canCopy boolean 현재 사용자가 이 파일을 복사할 수 있는지 여부입니다. 공유 드라이브에 있는 항목의 경우 현재 사용자가 이 폴더의 폴더 이외의 하위 항목을 복사할 수 있는지 여부 또는 항목이 아닌 경우 항목 자체를 복사할 수 있는지 여부
capabilities.canReadRevisions boolean 현재 사용자가 이 파일의 버전 리소스를 읽을 수 있는지 여부입니다. 공유 드라이브 항목의 경우 이 항목이 아닌 폴더의 하위 항목 또는 항목 자체가 폴더가 아닌 경우 이 항목 자체의 버전을 읽을 수 있습니다.
isAppAuthorized boolean 요청한 앱에서 파일을 만들었는지 또는 열었는지를 나타냅니다.
hasThumbnail boolean 파일에 썸네일이 있는지 여부 요청 앱에 썸네일에 대한 액세스 권한이 있는지는 나타내지 않습니다. 액세스 권한을 확인하려면 썸네일 링크 필드가 있는지 확인하세요.
thumbnailVersion long 썸네일 캐시 무효화에 사용할 썸네일 버전입니다.
modifiedByMe boolean 사용자가 파일을 수정했는지 여부
trashingUser nested object 파일을 명시적으로 휴지통으로 이동한 경우 해당 파일을 휴지통으로 이동한 사용자입니다. 공유 드라이브의 항목에 대해서만 채워집니다.
trashingUser.kind string 리소스 종류를 식별합니다. 값: 고정 문자열 "drive#user".
trashingUser.displayName string 이 사용자의 표시 가능한 일반 텍스트 이름입니다.
trashingUser.me boolean 이 사용자가 요청 사용자인지 여부입니다.
trashingUser.permissionId string 권한 리소스에 표시되는 사용자 ID입니다.
trashingUser.emailAddress string 사용자의 이메일 주소입니다. 사용자가 이메일 주소를 요청자에게 표시하지 않은 경우에는 특정 컨텍스트에서 표시되지 않을 수 있습니다.
trashedTime datetime 항목이 휴지통으로 이동된 시간입니다 (RFC 3339 날짜-시간). 공유 드라이브의 항목에 대해서만 채워집니다.
teamDriveId string driveId를 대신 사용하세요.
capabilities.canAddChildren boolean 현재 사용자가 이 폴더에 하위 요소를 추가할 수 있는지 여부입니다. 항목이 폴더가 아니면 항상 false입니다.
capabilities.canDelete boolean 현재 사용자가 이 파일을 삭제할 수 있는지 여부입니다.
capabilities.canDownload boolean 현재 사용자가 이 파일을 다운로드할 수 있는지 여부입니다.
capabilities.canListChildren boolean 현재 사용자가 이 폴더의 하위 항목을 나열할 수 있는지를 나타냅니다. 항목이 폴더가 아니면 항상 false입니다.
capabilities.canMoveTeamDriveItem boolean 지원 중단됨: 대신 canMoveItemWithinDrive 또는 canMoveItemOutOfDrive를 사용하세요.
capabilities.canMoveItemIntoTeamDrive boolean canMoveItemOutOfDrive를 대신 사용하세요.
capabilities.canReadTeamDrive boolean canReadDrive를 대신 사용하세요.
capabilities.canRemoveChildren boolean 현재 사용자가 이 폴더에서 하위 항목을 삭제할 수 있는지 여부입니다. 항목이 폴더가 아니면 항상 false입니다. 공유 드라이브에 있는 폴더의 경우 canDeleteChildren 또는 canTrashChildren를 대신 사용하세요.
capabilities.canRename boolean 현재 사용자가 이 파일의 이름을 바꿀 수 있는지 여부입니다.
capabilities.canTrash boolean 현재 사용자가 이 파일을 휴지통으로 이동할 수 있는지 여부입니다.
capabilities.canUntrash boolean 현재 사용자가 휴지통에서 이 파일을 복원할 수 있는지 여부입니다.
hasAugmentedPermissions boolean 이 파일에 대한 권한이 직접 있는지 여부입니다. 이 필드는 공유 드라이브의 항목에 대해서만 채워집니다.
capabilities.canChangeViewersCanCopyContent boolean
permissionIds[] list 이 파일에 액세스할 수 있는 사용자의 권한 ID 목록입니다.
capabilities.canChangeCopyRequiresWriterPermission boolean 현재 사용자가 이 파일의 copyRequiresWriterPermission 제한을 변경할 수 있는지 여부입니다.
copyRequiresWriterPermission boolean 독자와 댓글 작성자의 파일 복사, 인쇄, 다운로드 옵션이 사용 중지되어야 하는지 여부입니다. 쓰기 가능
capabilities.canDeleteChildren boolean 현재 사용자가 이 폴더의 하위 폴더를 삭제할 수 있는지 여부입니다. 항목이 폴더가 아니면 false입니다. 공유 드라이브의 항목에 대해서만 채워집니다.
capabilities.canMoveChildrenOutOfTeamDrive boolean canMoveChildrenOutOfDrive를 대신 사용하세요.
capabilities.canMoveChildrenWithinTeamDrive boolean canMoveChildrenWithinDrive를 대신 사용하세요.
capabilities.canMoveItemOutOfTeamDrive boolean canMoveItemOutOfDrive를 대신 사용하세요.
capabilities.canMoveItemWithinTeamDrive boolean canMoveItemWithinDrive를 대신 사용하세요.
capabilities.canTrashChildren boolean 현재 사용자가 이 폴더의 하위 폴더를 휴지통으로 이동할 수 있는지 여부입니다. 항목이 폴더가 아니면 false입니다. 공유 드라이브의 항목에 대해서만 채워집니다.
exportLinks.(key) string 내보내기 형식에서 URL로 매핑
driveId string 파일이 있는 공유 드라이브의 ID입니다. 공유 드라이브의 항목에 대해서만 채워집니다.
capabilities.canMoveChildrenOutOfDrive boolean 현재 사용자가 이 폴더의 하위 폴더를 공유 드라이브 외부로 이동할 수 있는지 여부입니다. 항목이 폴더가 아니면 false입니다. 공유 드라이브의 항목에 대해서만 채워집니다.
capabilities.canMoveChildrenWithinDrive boolean 현재 사용자가 이 드라이브 내에서 이 폴더의 하위 폴더를 이동할 수 있는지 여부입니다. 항목이 폴더가 아니면 false입니다. 현재 사용자 및 하위 폴더에 대한 현재 액세스 권한에 따라 하위 항목 이동 요청이 실패할 수 있습니다.
capabilities.canMoveItemOutOfDrive boolean 현재 사용자가 상위 항목을 변경하여 이 항목을 드라이브 외부로 이동할 수 있는지 여부입니다. 항목의 상위 항목을 변경하는 요청은 새로 추가되는 상위 항목에 따라 여전히 실패할 수 있습니다.
capabilities.canMoveItemWithinDrive boolean 현재 사용자가 이 드라이브 내에서 이 항목을 이동할 수 있는지 여부입니다. 항목의 상위 항목을 변경하는 요청은 추가되는 새 상위 요소와 삭제되는 상위 항목에 따라 여전히 실패할 수 있습니다.
capabilities.canReadDrive boolean 현재 사용자가 이 파일이 속한 공유 드라이브를 읽을 수 있는지 여부를 나타냅니다. 공유 드라이브의 항목에 대해서만 채워집니다.
capabilities.canModifyContent boolean 현재 사용자가 이 파일의 콘텐츠를 수정할 수 있는지 여부입니다.
capabilities.canAddMyDriveParent boolean 현재 사용자가 동일한 요청에서 기존 상위 항목을 삭제하지 않고도 항목에 상위 항목을 추가할 수 있는지 여부 공유 드라이브 파일에 입력되지 않았습니다.
capabilities.canRemoveMyDriveParent boolean 현재 사용자가 동일한 요청에서 다른 상위 항목을 추가하지 않고 항목에서 상위 항목을 삭제할 수 있는지 여부 공유 드라이브 파일에 입력되지 않았습니다.
shortcutDetails object 바로가기 파일 세부정보 mimeType 필드가 application/vnd.google-apps.shortcut로 설정된 바로가기 파일의 경우에만 채워집니다.
shortcutDetails.targetId string 이 바로가기가 가리키는 파일의 ID. 쓰기 가능
shortcutDetails.targetMimeType string 이 바로가기가 가리키는 파일의 MIME 유형입니다. 이 필드의 값은 대상의 MIME 유형의 스냅샷이며 바로가기를 만들 때 캡처됩니다.
capabilities.canAddFolderFromAnotherDrive boolean 현재 사용자가 다른 드라이브 (다른 공유 드라이브 또는 내 드라이브)의 폴더를 이 폴더에 추가할 수 있는지 여부입니다. 항목이 폴더가 아니면 false입니다. 공유 드라이브의 항목에 대해서만 채워집니다.
capabilities.canModifyContentRestriction boolean 현재 사용자가 이 파일의 콘텐츠에 대한 제한을 수정할 수 있는지 여부입니다.
contentRestrictions[] list 파일 콘텐츠 액세스에 대한 제한사항입니다. 이러한 제한이 있는 경우에만 채워집니다.
contentRestrictions[].readOnly boolean 파일 콘텐츠가 읽기 전용인지 여부 파일이 읽기 전용인 경우 파일의 새 버전이 추가되지 않으며, 댓글을 추가하거나 수정할 수 없으며, 파일의 제목도 수정할 수 없습니다. 쓰기 가능
contentRestrictions[].reason string 파일 콘텐츠가 제한되는 이유입니다. 이는 readOnly=true도 설정한 요청에서만 변경할 수 있습니다. 쓰기 가능
contentRestrictions[].restrictingUser nested object 콘텐츠 제한을 설정한 사용자입니다. readOnly이 true인 경우에만 채워집니다.
contentRestrictions[].restrictingUser.kind string 리소스 종류를 식별합니다. 값: 고정 문자열 "drive#user".
contentRestrictions[].restrictingUser.displayName string 이 사용자의 표시 가능한 일반 텍스트 이름입니다.
contentRestrictions[].restrictingUser.me boolean 이 사용자가 요청 사용자인지 여부입니다.
contentRestrictions[].restrictingUser.permissionId string 권한 리소스에 표시되는 사용자 ID입니다.
contentRestrictions[].restrictingUser.emailAddress string 사용자의 이메일 주소입니다. 사용자가 이메일 주소를 요청자에게 표시하지 않은 경우에는 특정 컨텍스트에서 표시되지 않을 수 있습니다.
contentRestrictions[].restrictionTime datetime 콘텐츠 제한이 설정된 시간입니다 (형식: RFC 3339 타임스탬프). readOnly이 true인 경우에만 채워집니다.
contentRestrictions[].type string 콘텐츠 제한 유형입니다. 현재 가능한 유일한 값은 globalContentRestriction입니다.
capabilities.canChangeSecurityUpdateEnabled boolean 현재 사용자가 링크 공유 메타데이터에서 securityUpdateEnabled 필드를 변경할 수 있는지 여부입니다.
shortcutDetails.targetResourceKey string 대상 파일의 ResourceKey.
resourceKey string 공유 링크를 통해 항목에 액세스하는 데 필요한 키입니다.
linkShareMetadata object 클라이언트가 이 항목을 참조하는 데 사용하는 링크 URL에 대한 세부정보가 포함되어 있습니다.
linkShareMetadata.securityUpdateEligible boolean 파일이 보안 업데이트 대상인지 여부
linkShareMetadata.securityUpdateEnabled boolean 이 파일에 보안 업데이트가 사용 설정되어 있는지 여부입니다.
capabilities.canAcceptOwnership boolean 현재 사용자가 파일의 대기 중인 소유자인지 여부 공유 드라이브 파일에 입력되지 않았습니다.
capabilities.canModifyLabels boolean 현재 사용자가 이 파일의 라벨을 수정할 수 있는지 여부입니다.
capabilities.canReadLabels boolean 현재 사용자가 이 파일의 라벨을 읽을 수 있는지 여부입니다.
labelInfo object 파일의 라벨 개요입니다.
labelInfo.labels[] list includeLabels 매개변수의 라벨 ID에 의해 요청된 파일의 라벨 집합입니다. 기본적으로 라벨이 반환되지 않습니다.
labelInfo.labels[].kind string 항상 drive#label입니다.
labelInfo.labels[].id string 라벨의 ID입니다.
labelInfo.labels[].revisionId string 라벨의 버전 ID입니다.
labelInfo.labels[].fields object 필드 ID로 키가 지정된 라벨 필드의 맵입니다.
labelInfo.labels[].fields.(key) nested object
labelInfo.labels[].fields.(key).kind string 이것은 항상 drive#labelField입니다.
labelInfo.labels[].fields.(key).id string 이 필드의 식별자입니다.
labelInfo.labels[].fields.(key).valueType string 필드 유형입니다. 향후 새 값이 지원될 수 있지만 현재 허용되는 값은 다음과 같습니다.
  • 날짜 문자열
  • 정수
  • 선택
  • 문자
  • 사용자
labelInfo.labels[].fields.(key).dateString[] list valueTypedateString인 경우에만 존재합니다. RFC 3339 형식 날짜: YYYY-MM-DD
labelInfo.labels[].fields.(key).integer[] list valueTypeinteger인 경우에만 존재합니다.
labelInfo.labels[].fields.(key).selection[] list valueTypeselection인 경우에만 존재합니다.
labelInfo.labels[].fields.(key).text[] list valueTypetext인 경우에만 존재합니다.
labelInfo.labels[].fields.(key).user[] list valueTypeuser인 경우에만 존재합니다.
labelInfo.labels[].fields.(key).user[].kind string 리소스 종류를 식별합니다. 값: 고정 문자열 "drive#user".
labelInfo.labels[].fields.(key).user[].displayName string 이 사용자의 표시 가능한 일반 텍스트 이름입니다.
labelInfo.labels[].fields.(key).user[].me boolean 이 사용자가 요청 사용자인지 여부입니다.
labelInfo.labels[].fields.(key).user[].permissionId string 권한 리소스에 표시되는 사용자 ID입니다.
labelInfo.labels[].fields.(key).user[].emailAddress string 사용자의 이메일 주소입니다. 사용자가 이메일 주소를 요청자에게 표시하지 않은 경우에는 특정 컨텍스트에서 표시되지 않을 수 있습니다.
sha1Checksum string 가능한 경우 이 파일과 연결된 SHA1 체크섬입니다. 이 입력란은 Google Drive에 저장된 콘텐츠가 있는 파일에만 입력되며, 문서 편집기나 바로가기 파일에는 입력되지 않습니다.
sha256Checksum string 가능한 경우 이 파일과 연결된 SHA256 체크섬입니다. 이 입력란은 Google Drive에 저장된 콘텐츠가 있는 파일에만 입력되며, 문서 편집기나 바로가기 파일에는 입력되지 않습니다.

방법

문구
파일 사본을 만들고 패치 시맨틱스를 사용하여 요청된 업데이트를 모두 적용합니다. 폴더를 복사할 수 없습니다.
만들기
파일을 만듭니다.
delete
사용자가 소유한 파일을 휴지통으로 이동하지 않고 완전히 삭제합니다. 파일이 공유 드라이브에 속한 경우 사용자가 상위 드라이브의 주최자여야 합니다. 타겟이 폴더인 경우 사용자가 소유한 모든 하위 항목도 삭제됩니다.
빈 휴지통
사용자의 휴지통 파일을 모두 삭제합니다.
내보내기
Google Workspace 문서를 요청된 MIME 유형으로 내보내고 내보낸 바이트 콘텐츠를 반환합니다. 내보낸 콘텐츠는 10MB로 제한됩니다.
생성 ID
만들기 또는 복사 요청에 제공할 수 있는 파일 ID 집합을 생성합니다.
가져오기
ID로 파일의 메타데이터 또는 콘텐츠를 가져옵니다.
list
파일 목록 또는 검색
업데이트
파일의 메타데이터 또는 콘텐츠를 업데이트합니다. 이 메서드를 호출할 때는 수정할 요청의 필드만 채웁니다. 필드를 업데이트하면 수정된 날짜와 같은 일부 필드가 자동으로 변경될 수 있습니다. 이 메서드는 패치 시맨틱스를 지원합니다.
시계
파일 변경사항을 구독합니다. 공유 드라이브의 파일을 변경할 수 있는 채널을 설정할 수 있지만 공유 드라이브 파일을 변경해도 알림이 생성되지 않습니다.
listLabel
파일의 라벨을 나열합니다.
modifyLabel
파일의 라벨 집합을 수정합니다.