Criar e gerenciar arquivos

Este guia explica como criar e gerenciar arquivos no Google Drive.

Criar arquivo

Para criar um arquivo no Drive que não tenha metadados nem conteúdo, use o método files.create sem parâmetros. O arquivo recebe um kind de drive.file, um id, um name de "Untitled" e um mimeType de application/octet-stream. O uploadType é marcado como obrigatório, mas o padrão é media. Portanto, você não precisa fornecê-lo.

Saiba mais sobre os limites de arquivos do Drive em Limites de arquivos e pastas.

Criar arquivos somente de metadados

Os arquivos somente de metadados não têm conteúdo. Metadados são dados (como name, mimeType e createdTime) que descrevem o arquivo. Campos como name não dependem de usuário e são exibidos da mesma forma para todos, enquanto campos como viewedByMeTime contêm valores específicos de usuário.

Um exemplo de arquivo somente de metadados é uma pasta com o tipo MIME application/vnd.google-apps.folder. Para saber mais, consulte Criar e preencher pastas. Outro exemplo é um atalho que aponta para outro arquivo no Drive com o tipo MIME application/vnd.google-apps.shortcut. Para saber mais, consulte Criar um atalho para um arquivo do Drive.

Gerenciar imagens em miniatura

As miniaturas ajudam os usuários a identificar os arquivos do Drive. O Drive pode gerar miniaturas automaticamente para tipos de arquivo comuns, ou você pode fornecer uma imagem em miniatura gerada pelo seu app. Para saber mais, consulte Fazer upload de miniaturas.

Copiar um arquivo

Para copiar um arquivo e aplicar as atualizações solicitadas, use o método files.copy. Para encontrar o fileId a ser copiado, use o método files.list.

É necessário usar um escopo adequado da API Drive para autorizar a chamada. Para mais informações sobre os escopos do Drive, consulte Escolher escopos da API Google Drive.

Limites e considerações

Ao se preparar para copiar arquivos, preste atenção nestes limites e considerações:

  • Permissões:

    • A restrição de arquivo copyRequiresWriterPermission determina quem pode copiar o arquivo. Para mais informações, consulte Impedir que os usuários façam o download, imprimam ou copiem seu arquivo.
    • O campo capabilities/canCopy de um recurso files determina se o usuário pode copiar um arquivo. Para mais informações, consulte Recursos.
    • O usuário que criou a cópia é o proprietário do arquivo copiado. Nenhuma outra configuração de compartilhamento do arquivo de origem é replicada. Se a cópia for criada em uma pasta compartilhada, ela herdará as permissões dessa pasta.
    • A propriedade de um arquivo copiado pode mudar e a cópia pode não herdar as configurações de compartilhamento do arquivo original. Talvez seja necessário redefinir essas configurações.

  • Gerenciamento de arquivos:

    • Alguns arquivos, como atalhos de terceiros, nunca podem ser copiados.
    • Só é possível copiar um arquivo para uma pasta principal. Não é possível especificar vários pais. Se o campo parents não for especificado, o arquivo vai herdar os pais detectáveis do arquivo de origem.
    • Mesmo que uma pasta seja um tipo de arquivo, não é possível copiar uma pasta. Em vez disso, crie uma pasta de destino e defina o campo parents dos arquivos existentes como a pasta de destino. Em seguida, você pode excluir a pasta de origem original.
    • A menos que um novo nome de arquivo seja especificado, o método files.copy produz um arquivo com o mesmo nome do original.
    • O uso excessivo de files.copy pode fazer com que os limites de cota da API Drive sejam excedidos. Para mais informações, consulte Limites de uso.

Confira aqui o que pode ser feito: