Drive API v2 및 v3 비교 참조

이 참조 페이지에서는 v2와 v3의 모든 리소스 차이를 설명합니다. 대상 자세히 알아보려면 Drive API v2와 v3 비교 가이드를 참고하세요.

v2와 v3의 메서드 차이점

이 표는 v3에서 변경된 v2 메서드를 보여줍니다.

v2 메서드 v3 메서드
children.delete ?removeParents=parent_id이 있는 자녀에 대한 files.update
children.get ?q='parent_id'+in+parents에서 files.list
children.insert ?addParents=parent_id이 있는 자녀에 대한 files.update
children.list ?q='parent_id'+in+parents에서 files.list
comments.insert comments.create
comments.patch comments.update
files.insert files.create
files.patch files.update
files.touch {'modifiedTime':'timestamp'}에서 files.update
files.trash {'trashed':true}에서 files.update
files.untrash {'trashed':false}에서 files.update
parents.delete ?removeParents=parent_id에서 files.update
parents.get ?fields=parents에서 files.get
parents.insert ?addParents=parent_id에서 files.update
parents.list ?fields=parents에서 files.get
permissions.getIdForEmail 해당 사항 없음
permissions.insert permissions.create
permissions.patch permissions.update
properties.delete 비공개: files.update, {'appProperties':{'key':null}}
공개: files.update, {'properties':{'key':null}}
properties.get 비공개: files.get(fields='appProperties' 포함)
공개: files.get(fields='properties' 포함)
properties.insert 비공개: files.update({'appProperties':{'key':'value'}} 포함)
공개: files.update({'properties':{'key':'value'}} 포함)
properties.list 비공개: files.get(fields='appProperties' 포함)
공개: files.get(fields='properties' 포함)
properties.update 비공개: files.update({'appProperties':{'key':'value'}} 포함)
공개: files.update({'properties':{'key':'value'}} 포함)
replies.insert replies.create
replies.patch replies.update
revisions.patch revisions.update

v2와 v3의 매개변수 차이

다음 표는 v2와 v3에서 동일하지만 다른 매개변수를 사용하는 메서드를 보여줍니다.

메서드 v2 매개변수 v3 매개변수
about.get includeSubscribed 해당 사항 없음
about.get maxChangeIdCount 해당 사항 없음
about.get startChangeId 해당 사항 없음
changes.list includeDeleted includeRemoved
changes.list includeSubscribed=true restrictToMyDrive=false
changes.list includeSubscribed=false restrictToMyDrive=true
changes.list maxResults pageSize
changes.list startChangeId pageToken
changes.list etag 해당 사항 없음
changes.list items changes
changes.list largestChangeId newStartPageToken
changes.list nextLink nextPageToken
changes.list selfLink 해당 사항 없음
comments.list maxResults pageSize
comments.list updatedMin startModifiedTime
comments.list nextLink nextPageToken
comments.list selfLink 해당 사항 없음
comments.list items comments
files.copy convert 리소스 본문에 타겟 mimeType 제공
files.copy ocr 이미지 가져오기에 OCR이 자동으로 사용 설정됩니다.
files.copy pinned keepRevisionForever
files.copy timedTextLanguage 해당 사항 없음
files.copy timedTextTrackName 해당 사항 없음
files.copy visibility=DEFAULT ignoreDefaultVisibility=false
files.copy visibility=PRIVATE ignoreDefaultVisibility=true
files.insert convert 리소스 본문에 타겟 mimeType 제공
files.insert ocr 이미지 가져오기에 OCR이 자동으로 사용 설정됩니다.
files.insert pinned keepRevisionForever
files.insert timedTextLanguage 해당 사항 없음
files.insert timedTextTrackName 해당 사항 없음
files.insert visibility=DEFAULT ignoreDefaultVisibility=false
files.insert visibility=PRIVATE ignoreDefaultVisibility=true
files.get projection 해당 사항 없음
files.get revisionId revisions.get
files.get updateViewedDate {'viewedByMeTime':'timestamp'}에서 files.update
files.generateIds maxResults count
files.list corpora=default corpus=user
files.list corpora=domain corpus=domain
files.list maxResults pageSize
files.list etag 해당 사항 없음
files.list items files
files.list nextLink nextPageToken
files.list selfLink 해당 사항 없음
files.update modifiedDateBehavior 리소스 본문에 제공되지 않은 경우 수정된 날짜가 자동으로 설정됩니다.
files.update newRevision 해당 사항 없음
files.update ocr 이미지 가져오기에 OCR이 자동으로 사용 설정됩니다.
files.update pinned keepRevisionForever
files.update setModifiedDate 해당 사항 없음
files.update timedTextLanguage 해당 사항 없음
files.update timedTextTrackName 해당 사항 없음
files.update updateViewedDate {'viewedByMeTime':'timestamp'}에서 files.update
permissions.insert sendNotificationEmails sendNotificationEmail
permissions.list etag 해당 사항 없음
permissions.list items permissions
permissions.list selfLink 해당 사항 없음
replies.list maxResults pageSize
replies.list items replies
replies.list nextLink nextPageToken
replies.list selfLink 해당 사항 없음
revisions.list etag 해당 사항 없음
revisions.list items revisions
revisions.list selfLink 해당 사항 없음

v2와 v3의 리소스 필드 차이점

이 표는 v2에서 v3으로 변경된 리소스 필드를 보여줍니다.

리소스 v2 Field v3 Field
About additionalRoleInfo 해당 사항 없음
About domainSharingPolicy 해당 사항 없음
About etag 해당 사항 없음
About features 해당 사항 없음
About languageCode 해당 사항 없음
About largestChangeId changes.getStartPageToken
About maxUploadSizes maxImportSizesmaxUploadSize
About name user.displayName
About permissionId user.permissionId
About quotaBytesByService 해당 사항 없음
About quotaType storageQuota.limit의 유무로 표시됩니다.
About remainingChangeIds 해당 사항 없음
About rootFolderId fileId=root, ?fields=id님과의 files.get
About selfLink 해당 사항 없음
About isCurrentAppInstalled appInstalled
About quotaBytesTotal storageQuota.limit
About quotaBytesUsed storageQuota.usageInDrive
About quotaBytesUsedAggregate storageQuota.usage
About quotaBytesUsedInTrash storageQuota.usageInDriveTrash
Apps etag 해당 사항 없음
Changes deleted removed
Changes id 해당 사항 없음
Changes selfLink 해당 사항 없음
Changes modificationDate time
Comments context.type quotedFileContent.mimeType
Comments context.value quotedFileContent.value
Comments createdDate createdTime
Comments fileId 해당 사항 없음
Comments fileTitle ?fields=name에서 files.get
Comments modifiedDate modifiedTime
Comments selfLink 해당 사항 없음
Comments status resolved
Files alternateLink webViewLink
Files appDataContents spaces
Files copyable capabilities.canCopy
Files createdDate createdTime
Files defaultOpenWithLink 해당 사항 없음
Files downloadUrl ?alt=media에서 files.get
Files editable capabilities.canEdit
Files embedLink 해당 사항 없음
Files etag 해당 사항 없음
Files fileSize size
Files imageMediaMetadata.date imageMediaMetadata.time
Files indexableText.text contentHints.indexableText
Files copyRequiresWriterPermission viewersCanCopyContent
Files labels.starred starred
Files labels.trashed trashed
Files labels.viewed viewedByMe
Files lastModifyingUserName lastModifyingUser.displayName
Files lastViewedByMeDate viewedByMeTime
Files modifiedByMeDate modifiedByMeTime
Files modifiedDate modifiedTime
Files openWithLinks 해당 사항 없음
Files ownerNames owners.displayName
Files selfLink 해당 사항 없음
Files sharedWithMeDate sharedWithMeTime
Files thumbnail.image contentHints.thumbnail.image
Files thumbnail.mimeType contentHints.thumbnail.mimeType
Files title name
Files userPermission ownedByMe, capabilities.canEdit, capabilities.canComment
Files webViewLink 해당 사항 없음
Permissions additionalRoles role
Permissions authKey 해당 사항 없음
Permissions etag 해당 사항 없음
Permissions name displayName
Permissions selfLink 해당 사항 없음
Permissions value emailAddress 또는 domain
Permissions withLink=true allowFileDiscovery=false
Permissions withLink=false allowFileDiscovery=true
Replies createdDate createdTime
Replies modifiedDate modifiedTime
Replies replyId id
Replies verb action
Revisions downloadUrl ?alt=media에서 revisions.get
Revisions etag 해당 사항 없음
Revisions fileSize size
Revisions lastModifyingUserName lastModifyingUser.displayName
Revisions modifiedDate modifiedTime
Revisions pinned keepForever
Revisions publishedLink 해당 사항 없음
Revisions selfLink 해당 사항 없음
Revisions isAuthenticatedUser me
Revisions lastModifyingUser.picture.url photoLink