Guia da API Drive v2

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

Para uma lista completa de diferenças, consulte a referência de comparação entre a API Drive v2 e a v3.

Fazer o download e publicar revisões de arquivos

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

Listar e fazer o download de revisões individuais

Depois de receber uma lista de 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 confie neles para uso posterior.

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

Propriedades de arquivo personalizadas

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

As propriedades são acessadas usando o recurso properties.

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

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

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

Ativar o suporte a drives compartilhados

Além das informações na página Implementar suporte a unidades compartilhadas, substitua este campo trashedDate para a v2.

Em Implementar suporte a drives compartilhados, os seguintes métodos exigem supportsAllDrives=true ao trabalhar com o 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 unidades compartilhadas. Para conferir uma lista de parâmetros, consulte a seção Acompanhar as alterações em um drive compartilhado.

Fazer upload de arquivos

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

Importar para tipos de Documentos Google

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

Compartilhar arquivos, pastas e unidades

Na página Compartilhar arquivos, pastas e drives, na v3, apenas um campo, role, especifica funções eficazes para usuário, grupo ou domínio. Na v2, os campos role e additionalRoles de uma permissão precisam refletir as funções eficazes que o usuário, grupo ou domínio têm para um determinado item.

Diferenças na consulta de pesquisa da v2

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

O campo createdDate da v2 é createdTime na v3. Para conferir exemplos, consulte Pesquisar unidades compartilhadas.

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.