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 |