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 do guia correspondente.

Para uma lista completa de diferenças, consulte a referência de comparação entre as APIs 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 seguintes informações são específicas da v2 e substituem estas seções mostradas para a v3:

Listar e baixar revisões individuais

Depois de receber uma lista das revisões de um arquivo, é possível baixar o conteúdo de qualquer revisão enviando uma solicitação GET autorizada à propriedade []downloadUrl](/workspace/drive/api/reference/rest/v2/revisions) dela. O Google Drive gera esse URL de curta duração quando você solicita a revisão. Não confie nele para uso posterior.

Você também pode exportar a revisão em um dos formatos compatíveis marcando a propriedade exportLinks.

Propriedades personalizadas de arquivos

Além das informações na página Adicionar propriedades de arquivo personalizadas, as seguintes informações são específicas da 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 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 suporte a unidades compartilhadas, substitua este campo adicional trashedDate pela v2.

Em Implementar suporte a drives compartilhados, os seguintes métodos 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 unidades compartilhadas. Para conferir uma lista de parâmetros, consulte a seção Acompanhar as mudanças em um drive compartilhado.

Fazer upload de arquivos

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

Importar para os tipos de 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 mimeType (workspace_name) do arquivo. Para mais informações, consulte Fazer upload de dados de arquivos.

Compartilhar arquivos, pastas e drives

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

Diferenças nas consultas de pesquisa para a 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 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.