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`	`ignoreDefaultVisibility=true`
`files.get`	`projection`	n/a
`files.get`	`revisionId`	`revisions.get`
`files.get`	`updateViewedDate`	`files.update` with `{'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`	n/a
`files.list`	`items`	`files`
`files.list`	`nextLink`	`nextPageToken`
`files.list`	`selfLink`	n/a
`files.update`	`modifiedDateBehavior`	The modified date is set automatically if not provided in the resource body.
`files.update`	`newRevision`	n/a
`files.update`	`ocr`	OCR is enabled automatically for image imports
`files.update`	`pinned`	`keepRevisionForever`
`files.update`	`setModifiedDate`	n/a
`files.update`	`timedTextLanguage`	n/a
`files.update`	`timedTextTrackName`	n/a
`files.update`	`updateViewedDate`	`files.update` with `{'viewedByMeTime':'timestamp'}`
`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

Resource field differences between v2 and v3

This table shows resource fields that have changed from v2 to v3.

Resource	v2 `Field`	v3 `Field`
`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` and `maxUploadSize`
`About`	`name`	`user.displayName`
`About`	`permissionId`	`user.permissionId`
`About`	`quotaBytesByService`	n/a
`About`	`quotaType`	Indicated by the presence or absence of `storageQuota.limit`
`About`	`remainingChangeIds`	n/a
`About`	`rootFolderId`	`files.get` with `fileId=root` and `?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`
`Apps`	`etag`	n/a
`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`	`files.get` with `?fields=name`
`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`	`files.get` with `?alt=media`
`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`	`ownedByMe`, `capabilities.canEdit`, `capabilities.canComment`
`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` or `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` with `?alt=media`
`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`