Criar e gerenciar arquivos

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

Criar arquivo

Para criar um arquivo no Drive sem 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 "Sem título" e mimeType de application/octet-stream. O uploadType é marcado como obrigatório, mas o padrão é media, para que você não precise fornecer reimplantá-lo.

Para mais informações sobre os limites de arquivos do Google Drive, consulte Arquivos e limites de pasta.

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 são independente de usuário e aparecem da mesma forma para todos os usuários, 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 miniaturas

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

Copiar um arquivo existente

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

É necessário usar uma API do Google Drive escopo para autorizar a chamada. Saiba mais sobre os escopos do Drive em 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 copie o arquivo. Para mais informações, consulte Impedir que os usuários o download, a impressão ou a cópia arquivo.
    • O campo capabilities/canCopy de um O 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. Nenhum outro compartilhamento do arquivo de origem são replicadas. Se a cópia for criada em uma pasta compartilhada, ela herda as permissões dela.
    • A propriedade de um arquivo copiado pode mudar, e a cópia pode não herdar as configurações de compartilhamento do arquivo original. Essas configurações podem precisar ser redefinido.
  • Gerenciamento de arquivos:

    • Alguns arquivos, como arquivos de terceiros atalhos de teclado, nunca podem ser copiado.
    • Só é possível copiar um arquivo para uma pasta principal. Especificar vários os pais não são compatíveis. Se o campo parents não for especificado, a herda 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 da arquivos existentes para a pasta de destino. Em seguida, você pode excluir na pasta original.
    • A menos que um novo nome de arquivo seja especificado, o método files.copy produz uma com o mesmo nome do original.
    • O uso excessivo do files.copy pode fazer com que você exceda Limites de cota da API Drive. Para mais informações, consulte Uso limites de desempenho.

Confira aqui o que pode ser feito: