Guia da API Drive v2

Se você usar a versão 2 da API Google Drive, a maior parte do conteúdo do Guia da API Google Drive v3 também será referente à v2. Esta seção contém todas as informações específicas da v2 e diferentes das mostradas em páginas específicas do guia da v3. Para o contexto completo, cada subseção contém o link para a página do guia correspondente.

Para conferir uma lista completa das diferenças, consulte a referência da API Drive v2 e v3.

Fazer o download e publicar revisões de arquivos

Na página Fazer o download e publicar revisões de arquivos, as informações a seguir são específicas da v2 e substituem as seções mostradas na v3:

Listar e fazer o download de revisões individuais

Depois de receber uma lista das revisões de um arquivo, é possível fazer o download do conteúdo de qualquer revisão enviando uma solicitação GET autorizada para a propriedade []downloadUrl](/drive/api/reference/rest/v2/revisions). O Google Drive gera esse URL de curta duração quando você solicita a revisão. Não dependa disso para usar depois.

Também é possível exportar a revisão em um dos formatos compatíveis verificando a propriedade exportLinks.

Propriedades do arquivo personalizado

Além das informações na página Adicionar propriedades de arquivo personalizadas, as seguintes informações são específicas para a v2:

As propriedades são acessadas usando o recurso properties.

Essa é a estrutura de uma propriedade típica que pode ser usada para armazenar o ID do banco de dados de um arquivo do Drive no arquivo.

{
  'key':        'additionalID',
  'value':      'ID',
  'visibility': 'PRIVATE'
}

Para mais informações sobre limites, consulte properties na documentação de referência.

Ativar a compatibilidade com o drive compartilhado

Além das informações na página Implementar o suporte ao drive compartilhado, substitua o campo adicional trashedDate para a v2.

Em Implementar o suporte a drives compartilhados, os métodos a seguir exigem supportsAllDrives=true ao trabalhar com conteúdo de drives compartilhados:

• files.get
• files.list
• files.insert
• files.update
• files.patch
• files.copy
• files.trash
• files.untrash
• files.delete
• files.touch
• children.insert
• parents.insert
• changes.list
• changes.getStartPageToken
• changes.get
• permissions.list
• permissions.get
• permissions.insert
• permissions.update
• permissions.patch
• permissions.delete

Os métodos changes.get e changes.list têm vários parâmetros específicos para drives compartilhados. Para conferir uma lista de parâmetros, consulte Controlar alterações em um drive compartilhado.

Fazer upload de arquivos

Na página Fazer upload de dados do arquivo, observe que estas informações são específicas para a v2:

Importar para tipos do Documentos Google

Ao criar um arquivo no Google Drive, você pode converter alguns tipos de arquivo em um documento do Documentos, Planilhas ou Apresentações Google. Inclua os files.insert convert parâmetros de consulta e defina a propriedade (workspace_name) mimeType do arquivo. Para mais informações, consulte Fazer upload de dados do arquivo.

Compartilhar arquivos, pastas e drives

Observe que, na página Compartilhar arquivos, pastas e drives, na v3 apenas um campo, role, especifica papéis eficazes para o usuário, grupo ou domínio. Na v2, é necessário que os campos role e additionalRoles de uma permissão reflitam as funções efetivas que o usuário, grupo ou domínio tem para um determinado item.

Diferenças das consultas de pesquisa da v2

O campo title da v2 é name na v3. Para ver exemplos, consulte Pesquisar arquivos e pastas.

O campo createdDate da v2 é createdTime na v3. Para ver exemplos, consulte Pesquisar drives compartilhados.

O campo modifiedDate da v2 é modifiedTime na v3. O campo lastViewedByMeDate da v2 é viewedByMeTime na v3. Para mais detalhes, consulte Termos e operadores de consulta de pesquisa.