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 contenha metadados ou 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 é definido como media por padrão. Portanto, não é necessário fornecer esse valor.

Para mais informações sobre os limites de arquivos do Drive, consulte Limites de arquivos e pastas.

Criar arquivos somente de metadados

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

Um exemplo de arquivo somente de metadados é uma pasta com o tipo MIME application/vnd.google-apps.folder. Para mais informações, 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 mais informações, consulte Criar um atalho para um arquivo do Drive.

Gerenciar imagens de 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 app. Para mais informações, 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 copiar, use o método files.list.

É necessário usar um escopo adequado da Drive API 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, observe estes 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, a impressão ou a cópia do 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 em uma pasta pai. Não é possível especificar vários pais. Se o campo parents não for especificado, o arquivo herdará todos os pais detectáveis do arquivo de origem.
    • Embora 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 atuais para a pasta de destino. Em seguida, exclua a pasta de origem original.
    • A menos que um novo nome de arquivo seja especificado, o método files.copy vai produzir um arquivo com o mesmo nome do original.
    • O uso excessivo de files.copy pode levar ao excesso dos limites de cota da API Drive. Para mais informações, consulte Limites de uso.

Confira algumas etapas que você pode seguir: