這份參考資料會列出 v2 和 v3 之間的所有資源差異。如要瞭解這兩個版本的高階差異,請參閱 Drive API 第 2 版和第 3 版比較指南。
v2 和 v3 的方法差異
下表列出 v3 中已變更的 v2 方法。
| v2 方法 | v3 方法 | 
|---|---|
children.delete | 
files.update 孩子的裝置上顯示 ?removeParents=parent_id | 
children.get | 
files.list (使用 ?q='parent_id'+in+parents 付款) | 
children.insert | 
files.update 孩子的裝置上顯示 ?addParents=parent_id | 
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 | 
系統會自動啟用光學字元辨識功能,以便匯入圖片 | 
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 | 
系統會自動啟用光學字元辨識功能,以便匯入圖片 | 
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 | 
系統會自動啟用光學字元辨識功能,以便匯入圖片 | 
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 |