Comparatif des API Drive v2 et v3

Cette 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 comparatif des API Drive v2 et v3.

Différences de méthode entre la v2 et la v3

Ce tableau présente les méthodes v2 qui ont été modifiées 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 v2 et la v3

Le tableau suivant présente les méthodes qui sont 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	Indiquez 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	Indiquez 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 des versions 2 et 3

Ce tableau indique les champs de ressources qui ont été modifiés 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	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