Drive API v2 and v3 comparison reference

This reference provides all resource differences between v2 and v3. For high-level differences between the two versions, see Drive API v2 and v3 comparison guide.

Method differences between v2 and v3

This table shows v2 methods that have changed in v3.

v2 Method	v3 Method
children.delete	files.update on the child with ?removeParents=parent_id
children.get	files.list with ?q='parent_id'+in+parents
children.insert	files.update on the child with ?addParents=parent_id
children.list	files.list with ?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 with {'modifiedTime':'timestamp'}
files.trash	files.update with {'trashed':true}
files.untrash	files.update with {'trashed':false}
parents.delete	files.update with ?removeParents=parent_id
parents.get	files.get with ?fields=parents
parents.insert	files.update with ?addParents=parent_id
parents.list	files.get with ?fields=parents
permissions.getIdForEmail	n/a
permissions.insert	permissions.create
permissions.patch	permissions.update
properties.delete	PRIVATE: files.update with {'appProperties':{'key':null}} PUBLIC: files.update with {'properties':{'key':null}}
properties.get	PRIVATE: files.get with fields='appProperties' PUBLIC: files.get with fields='properties'
properties.insert	PRIVATE: files.update with {'appProperties':{'key':'value'}} PUBLIC: files.update with {'properties':{'key':'value'}}
properties.list	PRIVATE: files.get with fields='appProperties' PUBLIC: files.get with fields='properties'
properties.update	PRIVATE: files.update with {'appProperties':{'key':'value'}} PUBLIC: files.update with {'properties':{'key':'value'}}
replies.insert	replies.create
replies.patch	replies.update
revisions.patch	revisions.update

Parameter differences between v2 and v3

The following table shows methods that are the same in v2 and v3, but take different parameters.

Method	v2 Parameter	v3 Parameter
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	Provide the target mimeType in the resource body
files.copy	ocr	OCR is enabled automatically for image imports
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	Provide the target mimeType in the resource body
files.insert	ocr	OCR is enabled automatically for image imports
files.insert	pinned	keepRevisionForever
files.insert	timedTextLanguage	n/a
files.insert	timedTextTrackName	n/a
files.insert	visibility=DEFAULT	ignoreDefaultVisibility=false
files.insert	visibility=PRIVATE