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 files.list 값을 ?q='parent_id'+in+parents로 교체
children.insert 자녀에 대해 ?addParents=parent_id이(가) 있는 경우 files.update
children.list files.list 값을 ?q='parent_id'+in+parents로 교체
comments.insert comments.create
comments.patch comments.update
files.insert files.create
files.patch files.update
files.touch files.update 값을 {'modifiedTime':'timestamp'}로 교체
files.trash files.update 값을 {'trashed':true}로 교체
files.untrash files.update 값을 {'trashed':false}로 교체
parents.delete files.update 값을 ?removeParents=parent_id로 교체
parents.get files.get 값을 ?fields=parents로 교체
parents.insert files.update 값을 ?addParents=parent_id로 교체
parents.list files.get 값을 ?fields=parents로 교체
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.getfields='appProperties'
공개: files.getfields='properties'
properties.insert 비공개: files.update{'appProperties':{'key':'value'}}
공개: files.update{'properties':{'key':'value'}}
properties.list 비공개: files.getfields='appProperties'
공개: files.getfields='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 files.update 값을 {'viewedByMeTime':'timestamp'}로 교체
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 files.update 값을 {'viewedByMeTime':'timestamp'}로 교체
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 files.get 값을 ?fields=name로 교체
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 files.get 값을 ?alt=media로 교체
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 revisions.get 값을 ?alt=media로 교체
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