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 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`