Cette page a été traduite par l'API Cloud Translation.

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 connaître les principales différences entre les deux versions, consultez le guide de comparaison entre les versions 2 et 3 des API Drive.

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` et `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`	Non disponible
`Revisions`	`isAuthenticatedUser`	`me`
`Revisions`	`lastModifyingUser.picture.url`	`photoLink`