A versão mais recente da API Google Drive é a v3. O desempenho na v3 é melhor porque as pesquisas retornam apenas um subconjunto de campos. Use a versão atual, a menos que você precise da coleção v2. Se estiver usando a v2, considere migrá-la para a v3. Para migrar, consulte Migrar para a API Drive v3. Para conferir uma lista completa das diferenças de versão, consulte a referência de comparação das APIs Drive v2 e v3.
Para continuar usando a v2, consulte a emenda do Guia da API Drive v2 para saber como algumas instruções dos guias da v3 precisam ser alteradas para os desenvolvedores da v2.
Para saber mais sobre as melhorias na API Drive v3, assista ao vídeo a seguir de engenheiros do Google discutindo o novo design da API.
Melhorias na V3
Para otimizar o desempenho e reduzir a complexidade do comportamento da API, a v3 oferece estas melhorias em relação à versão anterior da API:
- Por padrão, as pesquisas de arquivos e drives compartilhados não retornam recursos completos, apenas um subconjunto dos campos mais usados é retornado. Para mais detalhes sobre
fields
, consulte os métodosfiles.list
edrives.list
. - Quase todos os métodos que retornam uma resposta agora exigem o parâmetro
fields
. Para ver uma lista de todos os métodos que exigemfields
, consulte a referência da API Drive. - Os recursos com capacidades duplicadas foram removidos. Alguns exemplos:
- O método
files.list
realiza a mesma funcionalidade que as coleçõesChildren
eParents
, por isso foram removidos da v3. - Os métodos
Realtime.*
foram removidos.
- O método
- Por padrão, os dados de apps não são retornados nas pesquisas. Na v2, é possível definir o escopo
drive.appdata
. Ele retorna dados do aplicativo dos métodosfiles.list
echanges.list
, mas reduz o desempenho. Na v3, você define o escopodrive.appdata
e também o parâmetro de consultaspaces=appDataFolder
para solicitar dados do aplicativo. - Todas as operações de atualização usam PATCH em vez de PUT.
- Para exportar documentos do Google, use o
método
files.export
. - O comportamento do método
changes.list
é diferente. Em vez de IDs de mudança, use tokens de página opacos. Para pesquisar a coleção de mudanças, primeiro chame o métodochanges.getStartPageToken
para o valor inicial. Para consultas subsequentes, o métodochanges.list
retorna o valornewStartPageToken
. - Os métodos de atualização agora rejeitam solicitações que especificam campos não graváveis.
- Os campos
exportFormats
eimportFormats
da v2 no recursoabout
são listas de formatos de importação ou exportação permitidos. Na v3, eles são mapas do tipo MIME de destinos possíveis para todas as importações ou exportações compatíveis. - Os aliases
appdata
eappfolder
da v2 agora sãoappDataFolder
na v3. - O recurso
properties
é removido da v3. O recursofiles
tem o campoproperties
, que contém pares de chave-valor verdadeiros. O campoproperties
contém propriedades públicas, e o campoappProperties
contém propriedades particulares. Portanto, o campo de visibilidade não é necessário. - O campo
modifiedTime
no recursofiles
é atualizado na última vez em que qualquer pessoa modificou o arquivo. Na v2, o campomodifiedDate
só era mutável na atualização se você definir o camposetModifiedDate
. - O campo
viewedByMeTime
no recursofiles
não é atualizado automaticamente. - Para importar formatos do Documentos Google, defina o destino adequado
mimeType
no corpo do recurso. Na v2, você define?convert=true
. - As operações de importação retornam um erro 400 se não houver suporte para o formato.
- Os leitores e comentadores não têm acesso às permissões.
- O alias
me
das permissões foi removido. - Algumas funcionalidades estavam disponíveis como parte do recurso de solicitação, mas foram
disponibilizadas como um parâmetro de solicitação. Exemplo:
- Na v2, você pode usar
children.delete
para remover um arquivo filho de uma pasta pai. - Na v3,
files.update
é usado no filho com?removeParents=parent_id
no URL.
- Na v2, você pode usar
Outras diferenças
Os campos e os nomes dos parâmetros são diferentes na v3. Veja alguns exemplos:
- A propriedade
name
substituititle
no recursofiles
. Time
é o sufixo de todos os campos de data e hora em vez deDate
.- As operações de lista não usam o campo
items
para conter o conjunto de resultados. O tipo de recurso fornece um campo para os resultados (comofiles
ouchanges
).