Tài liệu tham khảo này trình bày tất cả các điểm khác biệt về tài nguyên giữa phiên bản 2 và phiên bản 3. Cho khác biệt cấp cao giữa hai phiên bản, hãy xem API Drive v2 và hướng dẫn so sánh phiên bản 3.
Sự khác biệt về phương pháp giữa phiên bản 2 và phiên bản 3
Bảng này cho thấy các phương thức v2 đã thay đổi trong v3.
Phương thức v2 | Phương thức v3 |
---|---|
children.delete |
files.update trên mạng con có ?removeParents=parent_id |
children.get |
files.list với ?q='parent_id'+in+parents |
children.insert |
files.update trên mạng con có ?addParents=parent_id |
children.list |
files.list với ?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 với {'modifiedTime':'timestamp'} |
files.trash |
files.update với {'trashed':true} |
files.untrash |
files.update với {'trashed':false} |
parents.delete |
files.update với ?removeParents=parent_id |
parents.get |
files.get với ?fields=parents |
parents.insert |
files.update với ?addParents=parent_id |
parents.list |
files.get với ?fields=parents |
permissions.getIdForEmail |
không áp dụng |
permissions.insert |
permissions.create |
permissions.patch |
permissions.update |
properties.delete |
RIÊNG TƯ: files.update với {'appProperties':{'key':null}} PUBLIC: files.update với {'properties':{'key':null}} |
properties.get |
RIÊNG TƯ: files.get với fields='appProperties' CÔNG KHAI: files.get với fields='properties' |
properties.insert |
RIÊNG TƯ: files.update với {'appProperties':{'key':'value'}} CÔNG KHAI: files.update với {'properties':{'key':'value'}} |
properties.list |
RIÊNG TƯ: files.get với fields='appProperties' CÔNG KHAI: files.get với fields='properties' |
properties.update |
RIÊNG TƯ: files.update với {'appProperties':{'key':'value'}} CÔNG KHAI: files.update với {'properties':{'key':'value'}} |
replies.insert |
replies.create |
replies.patch |
replies.update |
revisions.patch |
revisions.update |
Sự khác biệt về tham số giữa phiên bản 2 và phiên bản 3
Bảng sau đây cho thấy các phương thức giống nhau trong v2 và v3, nhưng có các tham số khác nhau.
Phương thức | Thông số v2 | Thông số v3 |
---|---|---|
about.get |
includeSubscribed |
không áp dụng |
about.get |
maxChangeIdCount |
không áp dụng |
about.get |
startChangeId |
không áp dụng |
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 |
không áp dụng |
changes.list |
items |
changes |
changes.list |
largestChangeId |
newStartPageToken |
changes.list |
nextLink |
nextPageToken |
changes.list |
selfLink |
không áp dụng |
comments.list |
maxResults |
pageSize |
comments.list |
updatedMin |
startModifiedTime |
comments.list |
nextLink |
nextPageToken |
comments.list |
selfLink |
không áp dụng |
comments.list |
items |
comments |
files.copy |
convert |
Cung cấp mimeType mục tiêu trong phần nội dung tài nguyên |
files.copy |
ocr |
Công nghệ Nhận dạng ký tự quang học (OCR) được bật tự động để nhập hình ảnh |
files.copy |
pinned |
keepRevisionForever |
files.copy |
timedTextLanguage |
không áp dụng |
files.copy |
timedTextTrackName |
không áp dụng |
files.copy |
visibility=DEFAULT |
ignoreDefaultVisibility=false |
files.copy |
visibility=PRIVATE |
ignoreDefaultVisibility=true |
files.insert |
convert |
Cung cấp mimeType mục tiêu trong phần nội dung tài nguyên |
files.insert |
ocr |
Công nghệ Nhận dạng ký tự quang học (OCR) được bật tự động để nhập hình ảnh |
files.insert |
pinned |
keepRevisionForever |
files.insert |
timedTextLanguage |
không áp dụng |
files.insert |
timedTextTrackName |
không áp dụng |
files.insert |
visibility=DEFAULT |
ignoreDefaultVisibility=false |
files.insert |
visibility=PRIVATE |
ignoreDefaultVisibility=true |
files.get |
projection |
không áp dụng |
files.get |
revisionId |
revisions.get |
files.get |
updateViewedDate |
files.update với {'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 |
không áp dụng |
files.list |
items |
files |
files.list |
nextLink |
nextPageToken |
files.list |
selfLink |
không áp dụng |
files.update |
modifiedDateBehavior |
Ngày sửa đổi sẽ tự động được đặt nếu không được cung cấp trong nội dung tài nguyên. |
files.update |
newRevision |
không áp dụng |
files.update |
ocr |
Công nghệ Nhận dạng ký tự quang học (OCR) được bật tự động để nhập hình ảnh |
files.update |
pinned |
keepRevisionForever |
files.update |
setModifiedDate |
không áp dụng |
files.update |
timedTextLanguage |
không áp dụng |
files.update |
timedTextTrackName |
không áp dụng |
files.update |
updateViewedDate |
files.update với {'viewedByMeTime':'timestamp'} |
permissions.insert |
sendNotificationEmails |
sendNotificationEmail |
permissions.list |
etag |
không áp dụng |
permissions.list |
items |
permissions |
permissions.list |
selfLink |
không áp dụng |
replies.list |
maxResults |
pageSize |
replies.list |
items |
replies |
replies.list |
nextLink |
nextPageToken |
replies.list |
selfLink |
không áp dụng |
revisions.list |
etag |
không áp dụng |
revisions.list |
items |
revisions |
revisions.list |
selfLink |
không áp dụng |
Sự khác biệt về trường tài nguyên giữa phiên bản 2 và phiên bản 3
Bảng này cho thấy các trường tài nguyên đã thay đổi từ v2 sang v3.
Tài nguyên | v2 Field |
v3 Field |
---|---|---|
About |
additionalRoleInfo |
không áp dụng |
About |
domainSharingPolicy |
không áp dụng |
About |
etag |
không áp dụng |
About |
features |
không áp dụng |
About |
languageCode |
không áp dụng |
About |
largestChangeId |
changes.getStartPageToken |
About |
maxUploadSizes |
maxImportSizes và maxUploadSize |
About |
name |
user.displayName |
About |
permissionId |
user.permissionId |
About |
quotaBytesByService |
không áp dụng |
About |
quotaType |
Được cho biết là có hay không có storageQuota.limit |
About |
remainingChangeIds |
không áp dụng |
About |
rootFolderId |
files.get cho thành viên fileId=root và ?fields=id |
About |
selfLink |
không áp dụng |
About |
isCurrentAppInstalled |
appInstalled |
About |
quotaBytesTotal |
storageQuota.limit |
About |
quotaBytesUsed |
storageQuota.usageInDrive |
About |
quotaBytesUsedAggregate |
storageQuota.usage |
About |
quotaBytesUsedInTrash |
storageQuota.usageInDriveTrash |
Apps |
etag |
không áp dụng |
Changes |
deleted |
removed |
Changes |
id |
không áp dụng |
Changes |
selfLink |
không áp dụng |
Changes |
modificationDate |
time |
Comments |
context.type |
quotedFileContent.mimeType |
Comments |
context.value |
quotedFileContent.value |
Comments |
createdDate |
createdTime |
Comments |
fileId |
không áp dụng |
Comments |
fileTitle |
files.get với ?fields=name |
Comments |
modifiedDate |
modifiedTime |
Comments |
selfLink |
không áp dụng |
Comments |
status |
resolved |
Files |
alternateLink |
webViewLink |
Files |
appDataContents |
spaces |
Files |
copyable |
capabilities.canCopy |
Files |
createdDate |
createdTime |
Files |
defaultOpenWithLink |
không áp dụng |
Files |
downloadUrl |
files.get với ?alt=media |
Files |
editable |
capabilities.canEdit |
Files |
embedLink |
không áp dụng |
Files |
etag |
không áp dụng |
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 |
không áp dụng |
Files |
ownerNames |
owners.displayName |
Files |
selfLink |
không áp dụng |
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 |
không áp dụng |
Permissions |
additionalRoles |
role |
Permissions |
authKey |
không áp dụng |
Permissions |
etag |
không áp dụng |
Permissions |
name |
displayName |
Permissions |
selfLink |
không áp dụng |
Permissions |
value |
emailAddress hoặc 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 với ?alt=media |
Revisions |
etag |
không áp dụng |
Revisions |
fileSize |
size |
Revisions |
lastModifyingUserName |
lastModifyingUser.displayName |
Revisions |
modifiedDate |
modifiedTime |
Revisions |
pinned |
keepForever |
Revisions |
publishedLink |
không áp dụng |
Revisions |
selfLink |
không áp dụng |
Revisions |
isAuthenticatedUser |
me |
Revisions |
lastModifyingUser.picture.url |
photoLink |