本頁面由 Cloud Translation API 翻譯而成。

Drive API 第 2 版和第 3 版比較參考資料

此參考資料提供 v2 和 v3 之間所有資源的差異。如需兩個版本之間的高階差異，請參閱 Drive API v3 與 v2 的比較。

第 2 版和第 3 版的方法差異

此表格顯示第 2 版的方法在第 3 版中已經變更。

v2 方法	v3 方法
`apps.get`	n/a
`apps.list`	n/a
`children.delete`	與`?removeParents=parent_id`分享的「`files.update`」
`children.get`	附有`?q='parent_id'+in+parents`的`files.list`
`children.insert`	與`?addParents=parent_id`分享的「`files.update`」
`children.list`	附有`?q='parent_id'+in+parents`的`files.list`
`comments.insert`	`comments.create`
`comments.patch`	`comments.update`
`files.insert`	`files.create`
`files.patch`	`files.update`
`files.touch`	附有`{'modifiedTime':'timestamp'}`的`files.update`
`files.trash`	附有`{'trashed':true}`的`files.update`
`files.untrash`	附有`{'trashed':false}`的`files.update`
`parents.delete`	附有`?removeParents=parent_id`的`files.update`
`parents.get`	附有`?fields=parents`的`files.get`
`parents.insert`	附有`?addParents=parent_id`的`files.update`
`parents.list`	附有`?fields=parents`的`files.get`
`permissions.getIdForEmail`	n/a
`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`

第 2 版和第 3 版參數的差異

下表顯示 v2 和 v3 相同，但採用的參數不同。

方法	v2 參數	v3 參數
`about.get`	`includeSubscribed`	n/a
`about.get`	`maxChangeIdCount`	n/a
`about.get`	`startChangeId`	n/a
`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`	n/a
`changes.list`	`items`	`changes`
`changes.list`	`largestChangeId`	`newStartPageToken`
`changes.list`	`nextLink`	`nextPageToken`
`changes.list`	`selfLink`	n/a
`comments.list`	`maxResults`	`pageSize`
`comments.list`	`updatedMin`	`startModifiedTime`
`comments.list`	`nextLink`	`nextPageToken`
`comments.list`	`selfLink`	n/a
`comments.list`	`items`	`comments`
`files.copy`	`convert`	在資源主體中提供目標 `mimeType`
`files.copy`	`ocr`	圖片匯入功能會自動啟用 OCR
`files.copy`	`pinned`	`keepRevisionForever`
`files.copy`	`timedTextLanguage`	n/a
`files.copy`	`timedTextTrackName`	n/a
`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`	n/a
`files.insert`	`timedTextTrackName`	n/a
`files.insert`	`visibility=DEFAULT`	`ignoreDefaultVisibility=false`
`files.insert`	`visibility=PRIVATE`	`ignoreDefaultVisibility=true`
`files.get`	`projection`	n/a
`files.get`	`revisionId`	`revisions.get`
`files.get`	`updateViewedDate`	附有`{'viewedByMeTime':'timestamp'}`的`files.update`
`files.generateIds`	`maxResults`	`count`
`files.list`	`corpora=default`	`corpus=user`
`files.list`	`corpora=domain`	`corpus=domain`
`files.list`	`maxResults`	`pageSize`
`files.list`	`etag`	n/a
`files.list`	`items`	`files`
`files.list`	`nextLink`	`nextPageToken`
`files.list`	`selfLink`	n/a
`files.update`	`modifiedDateBehavior`	如果資源主體未提供，則系統會自動設定修改日期。
`files.update`	`newRevision`	n/a
`files.update`	`ocr`	圖片匯入功能會自動啟用 OCR
`files.update`	`pinned`	`keepRevisionForever`
`files.update`	`setModifiedDate`	n/a
`files.update`	`timedTextLanguage`	n/a
`files.update`	`timedTextTrackName`	n/a
`files.update`	`updateViewedDate`	附有`{'viewedByMeTime':'timestamp'}`的`files.update`
`permissions.insert`	`sendNotificationEmails`	`sendNotificationEmail`
`permissions.list`	`etag`	n/a
`permissions.list`	`items`	`permissions`
`permissions.list`	`selfLink`	n/a
`replies.list`	`maxResults`	`pageSize`
`replies.list`	`items`	`replies`
`replies.list`	`nextLink`	`nextPageToken`
`replies.list`	`selfLink`	n/a
`revisions.list`	`etag`	n/a
`revisions.list`	`items`	`revisions`
`revisions.list`	`selfLink`	n/a

第 2 版和第 3 版之間的資源欄位差異

下表顯示從 v2 改為 v3 的資源欄位。

資源	`Field` 版本 2	`Field` 第 3 版
`About`	`additionalRoleInfo`	n/a
`About`	`domainSharingPolicy`	n/a
`About`	`etag`	n/a
`About`	`features`	n/a
`About`	`languageCode`	n/a
`About`	`largestChangeId`	`changes.getStartPageToken`
`About`	`maxUploadSizes`	`maxImportSizes`和`maxUploadSize`
`About`	`name`	`user.displayName`
`About`	`permissionId`	`user.permissionId`
`About`	`quotaBytesByService`	n/a
`About`	`quotaType`	由是否有 `storageQuota.limit` 出現
`About`	`remainingChangeIds`	n/a
`About`	`rootFolderId`	`files.get` (使用`fileId=root`和`?fields=id`)
`About`	`selfLink`	n/a
`About`	`isCurrentAppInstalled`	`appInstalled`
`About`	`quotaBytesTotal`	`storageQuota.limit`
`About`	`quotaBytesUsed`	`storageQuota.usageInDrive`
`About`	`quotaBytesUsedAggregate`	`storageQuota.usage`
`About`	`quotaBytesUsedInTrash`	`storageQuota.usageInDriveTrash`
`Changes`	`deleted`	`removed`
`Changes`	`id`	n/a
`Changes`	`selfLink`	n/a
`Changes`	`modificationDate`	`time`
`Comments`	`context.type`	`quotedFileContent.mimeType`
`Comments`	`context.value`	`quotedFileContent.value`
`Comments`	`createdDate`	`createdTime`
`Comments`	`fileId`	n/a
`Comments`	`fileTitle`	附有`?fields=name`的`files.get`
`Comments`	`modifiedDate`	`modifiedTime`
`Comments`	`selfLink`	n/a
`Comments`	`status`	`resolved`
`Files`	`alternateLink`	`webViewLink`
`Files`	`appDataContents`	`spaces`
`Files`	`copyable`	`capabilities.canCopy`
`Files`	`createdDate`	`createdTime`
`Files`	`defaultOpenWithLink`	n/a
`Files`	`downloadUrl`	附有`?alt=media`的`files.get`
`Files`	`editable`	`capabilities.canEdit`
`Files`	`embedLink`	n/a
`Files`	`etag`	n/a
`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`	n/a
`Files`	`ownerNames`	`owners.displayName`
`Files`	`selfLink`	n/a
`Files`	`sharedWithMeDate`	`sharedWithMeTime`
`Files`	`thumbnail.image`	`contentHints.thumbnail.image`
`Files`	`thumbnail.mimeType`	`contentHints.thumbnail.mimeType`
`Files`	`title`	`name`
`Files`	`userPermission`	`capabilities.canComment` 年取得`ownedByMecapabilities.canEdit`學位
`Files`	`webViewLink`	n/a
`Permissions`	`additionalRoles`	`role`
`Permissions`	`authKey`	n/a
`Permissions`	`etag`	n/a
`Permissions`	`name`	`displayName`
`Permissions`	`selfLink`	n/a
`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`	附有`?alt=media`的`revisions.get`
`Revisions`	`etag`	n/a
`Revisions`	`fileSize`	`size`
`Revisions`	`lastModifyingUserName`	`lastModifyingUser.displayName`
`Revisions`	`modifiedDate`	`modifiedTime`
`Revisions`	`pinned`	`keepForever`
`Revisions`	`publishedLink`	n/a
`Revisions`	`selfLink`	n/a
`Revisions`	`isAuthenticatedUser`	`me`
`Revisions`	`lastModifyingUser.picture.url`	`photoLink`