이 리소스에 대한 메소드 목록은 이 페이지의 하단에 나와 있습니다.
리소스 표현
파일의 메타데이터입니다.
{ "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입니다. 만들기 요청의 일부로 지정되지 않은 경우 파일은 사용자의 내 드라이브 폴더에 직접 저장됩니다. 복사 요청의 일부로 지정되지 않은 경우 파일은 소스 파일의 검색 가능한 상위 요소를 상속합니다. 업데이트 요청은 |
쓰기 가능 |
properties |
object |
모든 앱에 표시되는 임의의 키-값 쌍 모음입니다. null 값이 있는 항목은 업데이트 및 복사 요청에서 지워집니다. |
쓰기 가능 |
properties.(key) |
string |
||
appProperties |
object |
요청하는 앱에만 해당하는 임의의 키-값 쌍 모음입니다. null 값이 있는 항목은 업데이트 및 복사 요청에서 지워집니다. 이러한 속성은 인증된 요청을 사용해서만 가져올 수 있습니다. 인증된 요청은 OAuth 2 클라이언트 ID로 받은 액세스 토큰을 사용합니다. API 키를 사용하여 비공개 속성을 가져올 수 없습니다. |
쓰기 가능 |
appProperties.(key) |
string |
||
spaces[] |
list |
파일이 포함된 스페이스의 목록 현재 지원되는 값은 'drive', 'appDataFolder', 'photos'입니다. | |
version |
long |
파일의 단조롭게 증가하는 버전 번호입니다. 여기에는 서버에서 파일의 모든 변경사항이 반영됩니다(사용자에게 표시되지 않음 포함). | |
webContentLink |
string |
브라우저에서 파일의 콘텐츠를 다운로드하기 위한 링크입니다. 이 기능은 Google Drive에 바이너리 콘텐츠가 있는 파일에만 사용할 수 있습니다. | |
webViewLink |
string |
브라우저에서 관련 Google 편집기 또는 뷰어로 파일을 여는 링크 | |
iconLink |
string |
파일 아이콘에 대한 인증되지 않은 정적 링크입니다. | |
thumbnailLink |
string |
가능한 경우 파일의 썸네일에 대한 짧은 링크입니다. 일반적으로 몇 시간 동안 지속됩니다. 요청하는 앱이 파일의 콘텐츠에 액세스할 수 있을 때만 채워집니다. 파일이 공개적으로 공유되지 않으면 Files.thumbnailLink 에서 반환된 URL을 사용자 인증 정보 요청을 사용해 가져와야 합니다. |
|
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.photoLink |
string |
가능한 경우 사용자의 프로필 사진 링크입니다. | |
sharingUser.me |
boolean |
이 사용자가 요청 사용자인지 여부입니다. | |
sharingUser.permissionId |
string |
권한 리소스에 표시되는 사용자 ID입니다. | |
sharingUser.emailAddress |
string |
사용자의 이메일 주소입니다. 사용자가 이메일 주소를 요청자에게 표시하지 않은 경우에는 특정 컨텍스트에서 표시되지 않을 수 있습니다. | |
owners[] |
list |
이 파일의 소유자입니다. 특정 기존 파일에만 소유자가 두 명 이상 있을 수 있습니다. 이 필드는 공유 드라이브의 항목에 입력되지 않습니다. | |
owners[].kind |
string |
리소스 종류를 식별합니다. 값: 고정 문자열 "drive#user" . |
|
owners[].displayName |
string |
이 사용자의 표시 가능한 일반 텍스트 이름입니다. | |
owners[].photoLink |
string |
가능한 경우 사용자의 프로필 사진 링크입니다. | |
owners[].me |
boolean |
이 사용자가 요청 사용자인지 여부입니다. | |
owners[].permissionId |
string |
권한 리소스에 표시되는 사용자 ID입니다. | |
owners[].emailAddress |
string |
사용자의 이메일 주소입니다. 사용자가 이메일 주소를 요청자에게 표시하지 않은 경우에는 특정 컨텍스트에서 표시되지 않을 수 있습니다. | |
lastModifyingUser |
nested object |
파일을 수정한 마지막 사용자 | |
lastModifyingUser.kind |
string |
리소스 종류를 식별합니다. 값: 고정 문자열 "drive#user" . |
|
lastModifyingUser.displayName |
string |
이 사용자의 표시 가능한 일반 텍스트 이름입니다. | |
lastModifyingUser.photoLink |
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에 바이너리 콘텐츠가 있는 파일에만 사용할 수 있습니다.
|
|
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.photoLink |
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 |
object |
Docs 편집기 파일을 특정 형식으로 내보내기 위한 링크입니다. | |
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.photoLink |
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 |
valueType 가 dateString 인 경우에만 존재합니다. RFC 3339 형식 날짜: YYYY-MM-DD |
|
labelInfo.labels[].fields.(key).integer[] |
list |
valueType 가 integer 인 경우에만 존재합니다. |
|
labelInfo.labels[].fields.(key).selection[] |
list |
valueType 가 selection 인 경우에만 존재합니다. |
|
labelInfo.labels[].fields.(key).text[] |
list |
valueType 가 text 인 경우에만 존재합니다. |
|
labelInfo.labels[].fields.(key).user[] |
list |
valueType 가 user 인 경우에만 존재합니다. |
|
labelInfo.labels[].fields.(key).user[].kind |
string |
리소스 종류를 식별합니다. 값: 고정 문자열 "drive#user" . |
|
labelInfo.labels[].fields.(key).user[].displayName |
string |
이 사용자의 표시 가능한 일반 텍스트 이름입니다. | |
labelInfo.labels[].fields.(key).user[].photoLink |
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
- 파일의 라벨 집합을 수정합니다.