這份參考資料提供第 2 版和第 3 版的所有資源差異。適用對象 兩個版本的高階差異，請參閱 Drive API v2 與 第 3 版比較指南。
第 2 版和第 3 版的方法差異
下表顯示在 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}}PUBLIC： 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 |
第 2 版和第 3 版的參數差異
下表顯示第 2 版和第 3 版中相同，但採用不同參數的方法。
| 方法 | 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 |
不適用 |
第 2 版和第 3 版的資源欄位差異
這個表格顯示已從第 2 版變更為第 3 版的資源欄位。
| 資源 | 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 |