Comparatif des API Drive v2 et v3

Ce document de référence présente toutes les différences de ressources entre les versions 2 et 3. Pour les principales différences entre les deux versions, consultez la page API Drive v2 et comparatif de la version 3.

Différences entre les méthodes v2 et v3

Ce tableau présente les méthodes de la v2 qui ont été modifiées dans la v3.

Méthode v2 Méthode v3
children.delete files.update sur l'enfant avec ?removeParents=parent_id
children.get files.list avec ?q='parent_id'+in+parents
children.insert files.update sur l'enfant avec ?addParents=parent_id
children.list files.list avec ?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 avec {'modifiedTime':'timestamp'}
files.trash files.update avec {'trashed':true}
files.untrash files.update avec {'trashed':false}
parents.delete files.update avec ?removeParents=parent_id
parents.get files.get avec ?fields=parents
parents.insert files.update avec ?addParents=parent_id
parents.list files.get avec ?fields=parents
permissions.getIdForEmail n/a
permissions.insert permissions.create
permissions.patch permissions.update
properties.delete PRIVÉ: files.update avec {'appProperties':{'key':null}}
PUBLIC: files.update avec {'properties':{'key':null}}
properties.get PRIVÉ: files.get avec fields='appProperties'
PUBLIC: files.get avec fields='properties'
properties.insert PRIVÉ: files.update avec {'appProperties':{'key':'value'}}
PUBLIC: files.update avec {'properties':{'key':'value'}}
properties.list PRIVÉ: files.get avec fields='appProperties'
PUBLIC: files.get avec fields='properties'
properties.update PRIVÉ: files.update avec {'appProperties':{'key':'value'}}
PUBLIC: files.update avec {'properties':{'key':'value'}}
replies.insert replies.create
replies.patch replies.update
revisions.patch revisions.update

Différences de paramètres entre les versions 2 et 3

Le tableau suivant présente les méthodes identiques dans les versions 2 et 3, mais qui utilisent des paramètres différents.

Méthode Paramètre v2 Paramètre v3
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 Indiquez la cible mimeType dans le corps de la ressource
files.copy ocr La reconnaissance optique des caractères est activée automatiquement pour les importations d'images
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 Indiquez la cible mimeType dans le corps de la ressource
files.insert ocr La reconnaissance optique des caractères est activée automatiquement pour les importations d'images
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 avec {'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 date de modification est définie automatiquement si elle n'est pas indiquée dans le corps de la ressource.
files.update newRevision n/a
files.update ocr La reconnaissance optique des caractères est activée automatiquement pour les importations d'images
files.update pinned keepRevisionForever
files.update setModifiedDate n/a
files.update timedTextLanguage n/a
files.update timedTextTrackName n/a
files.update updateViewedDate files.update avec {'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

Différences au niveau des champs des ressources entre les versions 2 et 3

Ce tableau présente les champs de ressources qui sont passés de la version 2 à la version 3.

Ressource 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 et maxUploadSize
About name user.displayName
About permissionId user.permissionId
About quotaBytesByService n/a
About quotaType Indiqué par la présence ou l'absence de storageQuota.limit
About remainingChangeIds n/a
About rootFolderId files.get avec fileId=root et ?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 avec ?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 avec ?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 ou 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 avec ?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