Esta página foi traduzida pela API Cloud Translation.

Referência de comparação da API Drive v2 e v3

Esta referência mostra todas as diferenças de recursos entre a v2 e a v3. Para conhecer as diferenças de alto nível entre as duas versões, consulte o guia de comparação da API Drive v2 e v3.

Diferenças entre os métodos v2 e v3

Esta tabela mostra os métodos da v2 que foram alterados na v3.

Método v2	Método v3
`children.delete`	`files.update` na criança com `?removeParents=parent_id`
`children.get`	`files.list` com `?q='parent_id'+in+parents`
`children.insert`	`files.update` na criança com `?addParents=parent_id`
`children.list`	`files.list` com `?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` com `{'modifiedTime':'timestamp'}`
`files.trash`	`files.update` com `{'trashed':true}`
`files.untrash`	`files.update` com `{'trashed':false}`
`parents.delete`	`files.update` com `?removeParents=parent_id`
`parents.get`	`files.get` com `?fields=parents`
`parents.insert`	`files.update` com `?addParents=parent_id`
`parents.list`	`files.get` com `?fields=parents`
`permissions.getIdForEmail`	N/A
`permissions.insert`	`permissions.create`
`permissions.patch`	`permissions.update`
`properties.delete`	PRIVADO: `files.update` com `{'appProperties':{'key':null}}` PÚBLICO: `files.update` com `{'properties':{'key':null}}`
`properties.get`	PRIVADO: `files.get` com `fields='appProperties'` PÚBLICO: `files.get` com `fields='properties'`
`properties.insert`	PRIVADO: `files.update` com `{'appProperties':{'key':'value'}}` PÚBLICO: `files.update` com `{'properties':{'key':'value'}}`
`properties.list`	PRIVADO: `files.get` com `fields='appProperties'` PÚBLICO: `files.get` com `fields='properties'`
`properties.update`	PRIVADO: `files.update` com `{'appProperties':{'key':'value'}}` PÚBLICO: `files.update` com `{'properties':{'key':'value'}}`
`replies.insert`	`replies.create`
`replies.patch`	`replies.update`
`revisions.patch`	`revisions.update`

Diferenças de parâmetro entre a v2 e a v3

A tabela a seguir mostra métodos que são iguais na v2 e v3, mas usam parâmetros diferentes.

Método	Parâmetro v2	Parâmetro 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`	Fornecer o `mimeType` de destino no corpo do recurso
`files.copy`	`ocr`	O OCR é ativado automaticamente para importações de imagem
`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`	Fornecer o `mimeType` de destino no corpo do recurso
`files.insert`	`ocr`	O OCR é ativado automaticamente para importações de imagem
`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` com `{'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`	A data de modificação é definida automaticamente se não for fornecida no corpo do recurso.
`files.update`	`newRevision`	N/A
`files.update`	`ocr`	O OCR é ativado automaticamente para importações de imagem
`files.update`	`pinned`	`keepRevisionForever`
`files.update`	`setModifiedDate`	N/A
`files.update`	`timedTextLanguage`	N/A
`files.update`	`timedTextTrackName`	N/A
`files.update`	`updateViewedDate`	`files.update` com `{'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

Diferenças entre os campos de recursos da v2 e da v3

Esta tabela mostra os campos de recursos que mudaram da v2 para a v3.

Recurso	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` e `maxUploadSize`
`About`	`name`	`user.displayName`
`About`	`permissionId`	`user.permissionId`
`About`	`quotaBytesByService`	N/A
`About`	`quotaType`	Indicado pela presença ou ausência de `storageQuota.limit`
`About`	`remainingChangeIds`	N/A
`About`	`rootFolderId`	`files.get` com `fileId=root` e `?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` com `?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` com `?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` com `?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`