Porównanie interfejsu Drive API v2 i v3

Ten dokument referencyjny zawiera wszystkie różnice między zasobami w wersji 2 i 3. Ogólne różnice między tymi wersjami znajdziesz w przewodniku porównującym interfejsy Drive API w wersji 2 i 3.

Różnice w metodach między wersjami 2 i 3

Ta tabela zawiera metody w wersji 2, które uległy zmianie w wersji 3.

Metoda w wersji 2	Metoda w wersji 3
children.delete	files.update na dziecku z ?removeParents=parent_id
children.get	files.list i ?q='parent_id'+in+parents
children.insert	files.update na dziecku z ?addParents=parent_id
children.list	files.list i ?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 i {'modifiedTime':'timestamp'}
files.trash	files.update i {'trashed':true}
files.untrash	files.update i {'trashed':false}
parents.delete	files.update i ?removeParents=parent_id
parents.get	files.get i ?fields=parents
parents.insert	files.update i ?addParents=parent_id
parents.list	files.get i ?fields=parents
permissions.getIdForEmail	nie dotyczy
permissions.insert	permissions.create
permissions.patch	permissions.update
properties.delete	PRYWATNE: files.update z {'appProperties':{'key':null}} PUBLICZNE: files.update z {'properties':{'key':null}}
properties.get	PRYWATNE: files.get z fields='appProperties' PUBLICZNE: files.get z fields='properties'
properties.insert	PRYWATNE: files.update z {'appProperties':{'key':'value'}} PUBLICZNE: files.update z {'properties':{'key':'value'}}
properties.list	PRYWATNE: files.get z fields='appProperties' PUBLICZNE: files.get z fields='properties'
properties.update	PRYWATNE: files.update z {'appProperties':{'key':'value'}} PUBLICZNE: files.update z {'properties':{'key':'value'}}
replies.insert	replies.create
replies.patch	replies.update
revisions.patch	revisions.update

Różnice w parametrach między wersjami 2 i 3

W tabeli poniżej znajdziesz metody, które są takie same w wersjach 2 i 3, ale przyjmują różne parametry.

Metoda	Parametr v2	Parametr v3
about.get	includeSubscribed	nie dotyczy
about.get	maxChangeIdCount	nie dotyczy
about.get	startChangeId	nie dotyczy
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	nie dotyczy
changes.list	items	changes
changes.list	largestChangeId	newStartPageToken
changes.list	nextLink	nextPageToken
changes.list	selfLink	nie dotyczy
comments.list	maxResults	pageSize
comments.list	updatedMin	startModifiedTime
comments.list	nextLink	nextPageToken
comments.list	selfLink	nie dotyczy
comments.list	items	comments
files.copy	convert	Podaj docelowy mimeType w treści zasobu.
files.copy	ocr	Optyczne rozpoznawanie znaków jest automatycznie włączane w przypadku importowania obrazów.
files.copy	pinned	keepRevisionForever
files.copy	timedTextLanguage	nie dotyczy
files.copy	timedTextTrackName	nie dotyczy
files.copy	visibility=DEFAULT	ignoreDefaultVisibility=false
files.copy	visibility=PRIVATE	ignoreDefaultVisibility=true
files.insert	convert	Podaj docelowy mimeType w treści zasobu.
files.insert	ocr	Optyczne rozpoznawanie znaków jest automatycznie włączane w przypadku importowania obrazów.
files.insert	pinned	keepRevisionForever
files.insert	timedTextLanguage	nie dotyczy
files.insert	timedTextTrackName	nie dotyczy
files.insert	visibility=DEFAULT	ignoreDefaultVisibility=false
files.insert	visibility=PRIVATE	ignoreDefaultVisibility=true
files.get	projection	nie dotyczy
files.get	revisionId	revisions.get
files.get	updateViewedDate	files.update i {'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	nie dotyczy
files.list	items	files
files.list	nextLink	nextPageToken
files.list	selfLink	nie dotyczy
files.update	modifiedDateBehavior	Jeśli data modyfikacji nie zostanie podana w treści zasobu, zostanie ustawiona automatycznie.
files.update	newRevision	nie dotyczy
files.update	ocr	Optyczne rozpoznawanie znaków jest automatycznie włączane w przypadku importowania obrazów.
files.update	pinned	keepRevisionForever
files.update	setModifiedDate	nie dotyczy
files.update	timedTextLanguage	nie dotyczy
files.update	timedTextTrackName	nie dotyczy
files.update	updateViewedDate	files.update i {'viewedByMeTime':'timestamp'}
permissions.insert	sendNotificationEmails	sendNotificationEmail
permissions.list	etag	nie dotyczy
permissions.list	items	permissions
permissions.list	selfLink	nie dotyczy
replies.list	maxResults	pageSize
replies.list	items	replies
replies.list	nextLink	nextPageToken
replies.list	selfLink	nie dotyczy
revisions.list	etag	nie dotyczy
revisions.list	items	revisions
revisions.list	selfLink	nie dotyczy

Różnice w polach zasobów między wersjami 2 i 3

Ta tabela zawiera pola zasobów, które uległy zmianie w wersji 3 w porównaniu z wersją 2.

Zasób	v2 Field	v3 Field
About	additionalRoleInfo	nie dotyczy
About	domainSharingPolicy	nie dotyczy
About	etag	nie dotyczy
About	features	nie dotyczy
About	languageCode	nie dotyczy
About	largestChangeId	changes.getStartPageToken
About	maxUploadSizes	maxImportSizes i maxUploadSize
About	name	user.displayName
About	permissionId	user.permissionId
About	quotaBytesByService	nie dotyczy
About	quotaType	Wskazuje obecność lub brak elementu storageQuota.limit.
About	remainingChangeIds	nie dotyczy
About	rootFolderId	files.get z użytkownikami fileId=root i ?fields=id
About	selfLink	nie dotyczy
About	isCurrentAppInstalled	appInstalled
About	quotaBytesTotal	storageQuota.limit
About	quotaBytesUsed	storageQuota.usageInDrive
About	quotaBytesUsedAggregate	storageQuota.usage
About	quotaBytesUsedInTrash	storageQuota.usageInDriveTrash
Apps	etag	nie dotyczy
Changes	deleted	removed
Changes	id	nie dotyczy
Changes	selfLink	nie dotyczy
Changes	modificationDate	time
Comments	context.type	quotedFileContent.mimeType
Comments	context.value	quotedFileContent.value
Comments	createdDate	createdTime
Comments	fileId	nie dotyczy
Comments	fileTitle	files.get i ?fields=name
Comments	modifiedDate	modifiedTime
Comments	selfLink	nie dotyczy
Comments	status	resolved
Files	alternateLink	webViewLink
Files	appDataContents	spaces
Files	copyable	capabilities.canCopy
Files	createdDate	createdTime
Files	defaultOpenWithLink	nie dotyczy
Files	downloadUrl	files.get i ?alt=media
Files	editable	capabilities.canEdit
Files	embedLink	nie dotyczy
Files	etag	nie dotyczy
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	nie dotyczy
Files	ownerNames	owners.displayName
Files	selfLink	nie dotyczy
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	nie dotyczy
Permissions	additionalRoles	role
Permissions	authKey	nie dotyczy
Permissions	etag	nie dotyczy
Permissions	name	displayName
Permissions	selfLink	nie dotyczy
Permissions	value	emailAddress lub 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 i ?alt=media
Revisions	etag	nie dotyczy
Revisions	fileSize	size
Revisions	lastModifyingUserName	lastModifyingUser.displayName
Revisions	modifiedDate	modifiedTime
Revisions	pinned	keepForever
Revisions	publishedLink	nie dotyczy
Revisions	selfLink	nie dotyczy
Revisions	isAuthenticatedUser	me
Revisions	lastModifyingUser.picture.url	photoLink