Criar arquivos

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.

Confira aqui o que pode ser feito: