此参考文档提供了 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.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 | 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 | maxImportSizes和maxUploadSize |
About | name | user.displayName |
About | permissionId | user.permissionId |
About | quotaBytesByService | 无 |
About | quotaType | 通过是否存在 storageQuota.limit 来指示 |
About | remainingChangeIds | 无 |
About | rootFolderId | files.get（包含 fileId=root 和 ?fields=id） |
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 |