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 recursofiles
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.
- A restrição de arquivo
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.
Temas relacionados
Confira aqui o que pode ser feito:
Para fazer upload de dados de arquivos ao criar ou atualizar um arquivo, consulte Fazer upload dos dados do arquivo.
Para criar um arquivo em uma pasta específica, consulte Criar um arquivo em uma pasta específica.
Para trabalhar com metadados de arquivos, consulte Gerenciar metadados de arquivos.
Para excluir um arquivo, consulte Excluir ou excluir arquivos e pastas.