本參考資料提供 v2 和 v3 的所有資源差異。如要瞭解兩個版本之間的高階差異，請參閱 Drive API v2 和 v3 比較指南。
v2 和 v3 的方法差異
下表列出在第 3 版中變更的第 2 版方法。
| 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 |
n/a |
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' PUBLIC： files.get，另有 fields='properties' |
properties.insert |
私人：files.update，{'appProperties':{'key':'value'}} PUBLIC： files.update，另有 {'properties':{'key':'value'}} |
properties.list |
私人：files.get，fields='appProperties' PUBLIC： files.get，另有 fields='properties' |
properties.update |
私人：files.update，{'appProperties':{'key':'value'}} PUBLIC： files.update，另有 {'properties':{'key':'value'}} |
replies.insert |
replies.create |
replies.patch |
replies.update |
revisions.patch |
revisions.update |
v2 與 v3 的參數差異
下表列出在第 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 |
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 |
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 |
files.update 與{'viewedByMeTime':'timestamp'} 合作 |
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 |
v2 和 v3 的資源欄位差異
這個表格顯示已從 v2 變更為 v3 的資源欄位。
| 資源 | 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 |
maxImportSizes和maxUploadSize |
About |
name |
user.displayName |
About |
permissionId |
user.permissionId |
About |
quotaBytesByService |
n/a |
About |
quotaType |
顯示標記是「storageQuota.limit」是否存在 |
About |
remainingChangeIds |
n/a |
About |
rootFolderId |
使用fileId=root和?fields=id的files.get |
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 |
files.get 與?fields=name 合作 |
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 |
files.get 與?alt=media 合作 |
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 |
ownedByMe、capabilities.canEdit、capabilities.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 |
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 |
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 |