此参考文档介绍了 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 |
具有 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 |