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

Comparatif des API Drive v2 et v3

Cette référence fournit toutes les différences de ressources entre les versions 2 et 3. Pour connaître les différences générales entre les deux versions, consultez le guide de comparaison de l'API Drive v2 et v3.

Différences entre les méthodes v2 et v3

Ce tableau présente les méthodes de la version 2 qui ont changé dans la version 3.

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 la version 2 et la version 3

Le tableau suivant présente les méthodes identiques dans les versions 2 et 3, mais qui acceptent 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`	Fournissez le `mimeType` cible dans le corps de la ressource.
`files.copy`	`ocr`	La reconnaissance optique des caractères est automatiquement activée 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`	Fournissez le `mimeType` cible dans le corps de la ressource.
`files.insert`	`ocr`	La reconnaissance optique des caractères est automatiquement activée 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 fournie dans le corps de la ressource.
`files.update`	`newRevision`	n/a
`files.update`	`ocr`	La reconnaissance optique des caractères est automatiquement activée 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 entre les champs de ressources de la version 2 et de la version 3

Ce tableau présente les champs de ressources qui ont changé entre la version 2 et 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`	Indique 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`