Drive API v2 和 v3 的比較參考資料

這份參考資料提供第 2 版和第 3 版的所有資源差異。如要瞭解兩版之間差異的主要差異,請參閱 Drive API v2 和 v3 比較指南

第 2 版和第 3 版的方法差異

下表顯示在 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 n/a
permissions.insert permissions.create
permissions.patch permissions.update
properties.delete 私人:files.update,分享對象:{'appProperties':{'key':null}}
PUBLIC:files.update,分享對象:{'properties':{'key':null}}
properties.get 私人:files.getfields='appProperties'
公開:files.get,公開:fields='properties'
properties.insert 私人:files.update{'appProperties':{'key':'value'}}
公開:files.update,公開:{'properties':{'key':'value'}}
properties.list 私人:files.getfields='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

第 2 版和第 3 版的參數差異

下表顯示第 2 版和第 3 版中相同,但採用不同參數的方法。

方法 v2 參數 v3 參數
about.get includeSubscribed n/a
about.get maxChangeIdCount n/a
about.get startChangeId n/a
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 n/a
changes.list items changes
changes.list largestChangeId newStartPageToken
changes.list nextLink nextPageToken
changes.list selfLink n/a
comments.list maxResults pageSize
comments.list updatedMin startModifiedTime
comments.list nextLink nextPageToken
comments.list selfLink n/a
comments.list items comments
files.copy convert 在資源主體中提供目標 mimeType
files.copy ocr 系統會自動啟用 OCR 以匯入圖片
files.copy pinned keepRevisionForever
files.copy timedTextLanguage n/a
files.copy timedTextTrackName n/a
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 n/a
files.insert timedTextTrackName n/a
files.insert visibility=DEFAULT ignoreDefaultVisibility=false
files.insert visibility=PRIVATE ignoreDefaultVisibility=true
files.get projection n/a
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 n/a
files.list items files
files.list nextLink nextPageToken
files.list selfLink n/a
files.update modifiedDateBehavior 如果資源主體中沒有修改日期,系統會自動設定修改日期。
files.update newRevision n/a
files.update ocr 系統會自動啟用 OCR 以匯入圖片
files.update pinned keepRevisionForever
files.update setModifiedDate n/a
files.update timedTextLanguage n/a
files.update timedTextTrackName n/a
files.update updateViewedDate {'viewedByMeTime':'timestamp'}會員價 files.update
permissions.insert sendNotificationEmails sendNotificationEmail
permissions.list etag n/a
permissions.list items permissions
permissions.list selfLink n/a
replies.list maxResults pageSize
replies.list items replies
replies.list nextLink nextPageToken
replies.list selfLink n/a
revisions.list etag n/a
revisions.list items revisions
revisions.list selfLink n/a

第 2 版和第 3 版的資源欄位差異

這個表格顯示已從第 2 版變更為第 3 版的資源欄位。

資源 v2 Field v3 Field
About additionalRoleInfo n/a
About domainSharingPolicy n/a
About etag n/a
About features n/a
About languageCode n/a
About largestChangeId changes.getStartPageToken
About maxUploadSizes maxImportSizesmaxUploadSize
About name user.displayName
About permissionId user.permissionId
About quotaBytesByService n/a
About quotaType 指出是否存在「storageQuota.limit
About remainingChangeIds n/a
About rootFolderId files.get fileId=root?fields=id
About selfLink n/a
About isCurrentAppInstalled appInstalled
About quotaBytesTotal storageQuota.limit
About quotaBytesUsed storageQuota.usageInDrive
About quotaBytesUsedAggregate storageQuota.usage
About quotaBytesUsedInTrash storageQuota.usageInDriveTrash
Apps etag n/a
Changes deleted removed
Changes id n/a
Changes selfLink n/a
Changes modificationDate time
Comments context.type quotedFileContent.mimeType
Comments context.value quotedFileContent.value
Comments createdDate createdTime
Comments fileId n/a
Comments fileTitle ?fields=name會員價 files.get
Comments modifiedDate modifiedTime
Comments selfLink n/a
Comments status resolved
Files alternateLink webViewLink
Files appDataContents spaces
Files copyable capabilities.canCopy
Files createdDate createdTime
Files defaultOpenWithLink n/a
Files downloadUrl ?alt=media會員價 files.get
Files editable capabilities.canEdit
Files embedLink n/a
Files etag n/a
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 n/a
Files ownerNames owners.displayName
Files selfLink n/a
Files sharedWithMeDate sharedWithMeTime
Files thumbnail.image contentHints.thumbnail.image
Files thumbnail.mimeType contentHints.thumbnail.mimeType
Files title name
Files userPermission ownedByMecapabilities.canEditcapabilities.canComment
Files webViewLink n/a
Permissions additionalRoles role
Permissions authKey n/a
Permissions etag n/a
Permissions name displayName
Permissions selfLink n/a
Permissions value emailAddressdomain
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 n/a
Revisions fileSize size
Revisions lastModifyingUserName lastModifyingUser.displayName
Revisions modifiedDate modifiedTime
Revisions pinned keepForever
Revisions publishedLink n/a
Revisions selfLink n/a
Revisions isAuthenticatedUser me
Revisions lastModifyingUser.picture.url photoLink