Tài liệu tham khảo so sánh API Drive phiên bản 2 và phiên bản 3

Tài liệu tham khảo này cung cấp tất 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. Để biết sự khác biệt tổng quan giữa hai phiên bản, hãy xem hướng dẫn so sánh API Drive phiên bản 2 và 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 pháp phiên bản 3
children.delete files.update trên phần tử con có ?removeParents=parent_id
children.get files.list cộng tác với ?q='parent_id'+in+parents
children.insert files.update trên phần tử con có ?addParents=parent_id
children.list files.list cộng tác 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 cộng tác với {'modifiedTime':'timestamp'}
files.trash files.update cộng tác với {'trashed':true}
files.untrash files.update cộng tác với {'trashed':false}
parents.delete files.update cộng tác với ?removeParents=parent_id
parents.get files.get cộng tác với ?fields=parents
parents.insert files.update cộng tác với ?addParents=parent_id
parents.list files.get cộng tác 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}}
CÔNG KHAI: 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ề thông số giữa phiên bản 2 và phiên bản 3

Bảng sau đây trình bày các phương thức giống nhau trong v2 và v3, nhưng lấy các tham số khác nhau.

Phương thức Tham số v2 Tham 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 đích trong nội dung tài nguyên
files.copy ocr Công nghệ nhận dạng ký tự quang học (OCR) được tự động bật để 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 đích trong nội dung tài nguyên
files.insert ocr Công nghệ nhận dạng ký tự quang học (OCR) được tự động bật để 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 cộng tác 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 được đặt tự động nếu không được cung cấp trong phần nội dung của 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 tự động bật để 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 cộng tác 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 biết 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 Biểu thị bằng sự có mặt hay không có storageQuota.limit
About remainingChangeIds không áp dụng
About rootFolderId files.get với 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 cộng tác 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 cộng tác 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 cộng tác 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