這份參考資料會列出 v2 和 v3 之間的所有資源差異。如要瞭解這兩個版本的高階差異,請參閱 Google Drive API v2 和 v3 比較指南。
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 |