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