Referencia comparativa de la API de Drive v2 y v3

En esta referencia, se proporcionan todas las diferencias de recursos entre la v2 y la v3. Para diferencias de alto nivel entre las dos versiones, consulta API de Drive v2 y Guía de comparación de la versión 3.

Diferencias de métodos entre v2 y v3

En esta tabla, se muestran los métodos de la v2 que cambiaron en la v3.

Método v2 Método v3
children.delete files.update en el elemento secundario con ?removeParents=parent_id
children.get files.list con ?q='parent_id'+in+parents
children.insert files.update en el elemento secundario con ?addParents=parent_id
children.list files.list con ?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 con {'modifiedTime':'timestamp'}
files.trash files.update con {'trashed':true}
files.untrash files.update con {'trashed':false}
parents.delete files.update con ?removeParents=parent_id
parents.get files.get con ?fields=parents
parents.insert files.update con ?addParents=parent_id
parents.list files.get con ?fields=parents
permissions.getIdForEmail N/A
permissions.insert permissions.create
permissions.patch permissions.update
properties.delete PRIVADO: files.update con {'appProperties':{'key':null}}
PÚBLICO: files.update con {'properties':{'key':null}}
properties.get PRIVADO: files.get con fields='appProperties'
PÚBLICO: files.get con fields='properties'
properties.insert PRIVADO: files.update con {'appProperties':{'key':'value'}}
PÚBLICO: files.update con {'properties':{'key':'value'}}
properties.list PRIVADO: files.get con fields='appProperties'
PÚBLICO: files.get con fields='properties'
properties.update PRIVADO: files.update con {'appProperties':{'key':'value'}}
PÚBLICO: files.update con {'properties':{'key':'value'}}
replies.insert replies.create
replies.patch replies.update
revisions.patch revisions.update

Diferencias de parámetros entre v2 y v3

En la siguiente tabla, se muestran métodos que son iguales en la v2 y la v3, pero con parámetros diferentes.

Método Parámetro v2 Parámetro de v3
about.get includeSubscribed N/A
about.get maxChangeIdCount No disponible
about.get startChangeId No disponible
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 No disponible
changes.list items changes
changes.list largestChangeId newStartPageToken
changes.list nextLink nextPageToken
changes.list selfLink No disponible
comments.list maxResults pageSize
comments.list updatedMin startModifiedTime
comments.list nextLink nextPageToken
comments.list selfLink N/A
comments.list items comments
files.copy convert Proporciona el mimeType de destino en el cuerpo del recurso
files.copy ocr El OCR se habilita automáticamente para las importaciones de imágenes
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 Proporciona el mimeType de destino en el cuerpo del recurso
files.insert ocr El OCR se habilita automáticamente para las importaciones de imágenes
files.insert pinned keepRevisionForever
files.insert timedTextLanguage N/A
files.insert timedTextTrackName No disponible
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 con {'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 La fecha de modificación se establece automáticamente si no se proporciona en el cuerpo del recurso.
files.update newRevision N/A
files.update ocr El OCR se habilita automáticamente para las importaciones de imágenes
files.update pinned keepRevisionForever
files.update setModifiedDate N/A
files.update timedTextLanguage No disponible
files.update timedTextTrackName N/A
files.update updateViewedDate files.update con {'viewedByMeTime':'timestamp'}
permissions.insert sendNotificationEmails sendNotificationEmail
permissions.list etag N/A
permissions.list items permissions
permissions.list selfLink No disponible
replies.list maxResults pageSize
replies.list items replies
replies.list nextLink nextPageToken
replies.list selfLink No disponible
revisions.list etag No disponible
revisions.list items revisions
revisions.list selfLink N/A

Diferencias en los campos de recursos entre la v2 y la v3

En esta tabla, se muestran los campos de recursos que cambiaron de la v2 a la v3.

Recurso v2 Field v3 Field
About additionalRoleInfo N/A
About domainSharingPolicy No disponible
About etag No disponible
About features No disponible
About languageCode N/A
About largestChangeId changes.getStartPageToken
About maxUploadSizes maxImportSizes y maxUploadSize
About name user.displayName
About permissionId user.permissionId
About quotaBytesByService N/A
About quotaType Se indica en función de la presencia o ausencia de storageQuota.limit
About remainingChangeIds N/A
About rootFolderId files.get con fileId=root y ?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 No disponible
Changes deleted removed
Changes id No disponible
Changes selfLink No disponible
Changes modificationDate time
Comments context.type quotedFileContent.mimeType
Comments context.value quotedFileContent.value
Comments createdDate createdTime
Comments fileId N/A
Comments fileTitle files.get con ?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 con ?alt=media
Files editable capabilities.canEdit
Files embedLink N/A
Files etag No disponible
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 No disponible
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 No disponible
Permissions etag No disponible
Permissions name displayName
Permissions selfLink N/A
Permissions value emailAddress o 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 con ?alt=media
Revisions etag N/A
Revisions fileSize size
Revisions lastModifyingUserName lastModifyingUser.displayName
Revisions modifiedDate modifiedTime
Revisions pinned keepForever
Revisions publishedLink No disponible
Revisions selfLink N/A
Revisions isAuthenticatedUser me
Revisions lastModifyingUser.picture.url photoLink