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 das mostradas em páginas específicas do guia da v3. Para entender o contexto completo, cada subseção contém o link para a página do guia correspondente.

Para ver uma lista completa das diferenças, consulte a referência de comparação 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 dessa pesquisa para uso posterior.

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

Propriedades de arquivos personalizados

Além das informações na página Adicionar propriedades de arquivo personalizado, as seguintes informações são específicas da 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 o suporte a drives compartilhados

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

Em Implementar o suporte a drives compartilhados, os métodos abaixo 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 ver uma lista de parâmetros, consulte a seção 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 da 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 parâmetros de consulta files.insert convert 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 efetivos para usuário, grupo ou domínio. Na v2, os campos role e additionalRoles de uma permissão refletem os papéis efetivos do usuário, grupo ou domínio em um determinado item.

Diferenças de consultas de pesquisa para a v2

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

O campo createdDate da v2 é createdTime na v3. Para 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.