Para criar um arquivo sem 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
está marcado como obrigatório, mas o padrão é media
para que você não precise 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.
Enviar miniaturas
O Drive gera automaticamente miniaturas para muitos tipos de arquivo comuns, como Documentos, Planilhas e Apresentações. As miniaturas ajudam o usuário a identificar melhor os arquivos do Drive.
Para tipos de arquivo em que o Drive não pode gerar uma miniatura padrão, é possível fornecer uma imagem em miniatura gerada pelo seu aplicativo. Durante
a criação ou atualização do arquivo, faça o upload de uma miniatura configurando o campo
contentHints.thumbnail
no recurso files
.
Mais especificamente:
- Defina o campo
contentHints.thumbnail.image
como o URL e o nome de arquivo da imagem codificada em base64 segura. Consulte a seção 5 do RFC 4648 (link em inglês). - Defina o campo
contentHints.thumbnail.mimeType
como o tipo MIME adequado para a miniatura.
Se o Drive puder gerar uma miniatura a partir do arquivo, ele usará a miniatura gerada automaticamente e ignorará qualquer miniatura enviada. Se não for possível gerar uma miniatura, ela usará a que você forneceu.
As miniaturas devem seguir estas regras:
- Pode ser enviado nos formatos PNG, GIF ou JPG.
- A largura recomendada é de 1600 pixels.
- A largura mínima é de 220 pixels.
- O tamanho máximo do arquivo é de 2 MB.
- Eles devem ser atualizados pelo aplicativo a cada salvamento.
Para mais informações, consulte o recurso files
.
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.