Drive API v2 与 v3 比较参考文档

此参考文档提供了 v2 和 v3 之间的所有资源差异。如需了解这两个版本之间的高级别差异，请参阅 Drive API v2 和 v3 比较指南。

v2 和 v3 之间的方法差异

下表显示了 v3 中已更改的 v2 方法。

v2 方法	v3 方法
children.delete	对具有 ?removeParents=parent_id 的子级应用 files.update
children.get	files.list 与 ?q='parent_id'+in+parents 合作
children.insert	对具有 ?addParents=parent_id 的子级应用 files.update
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	系统会自动为导入的图片启用 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	系统会自动为导入的图片启用 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	系统会自动为导入的图片启用 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