Method: files.insert

Insere um novo arquivo.

Esse método é compatível com um URI de /upload e aceita mídias enviadas com as seguintes características:

  • Tamanho máximo do arquivo: 5.120 GB
  • Tipos MIME de mídia aceitos:*/*

Observação: especifique um tipo MIME válido, em vez do valor */* literal. O */* literal é usado apenas para indicar que qualquer tipo MIME válido pode ser enviado.

Para mais informações sobre o upload de arquivos, consulte Fazer o upload de dados do arquivo.

Os apps que criam atalhos com files.insert precisam especificar o tipo MIME application/vnd.google-apps.shortcut.

Os apps precisam especificar uma extensão de arquivo na propriedade title ao inserir arquivos com a API. Por exemplo, uma operação para inserir um arquivo JPEG precisa especificar algo como "title": "cat.jpg" nos metadados.

As solicitações GET subsequentes incluem a propriedade fileExtension somente leitura preenchida com a extensão especificada originalmente na propriedade title. Quando um usuário do Google Drive solicita o download de um arquivo ou o download dele é feito pelo cliente de sincronização, o Drive cria um nome de arquivo completo (com extensão) com base no título. Quando a extensão está ausente, o Drive tenta determinar a extensão com base no tipo MIME do arquivo.

Solicitação HTTP

  • URI de upload para solicitações de upload de mídia:
    POST https://www.googleapis.com/upload/drive/v2/files
  • URI de metadados, para solicitações somente de metadados:
    POST https://www.googleapis.com/drive/v2/files

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de consulta

Parâmetros
uploadType

string

É o tipo de solicitação de upload para o URI /upload. Se você estiver fazendo upload de dados com um URI /upload, esse campo será obrigatório. Se você estiver criando um arquivo somente de metadados, este campo não é obrigatório. Além disso, esse campo não aparece no widget "Testar este método" porque o widget não é compatível com uploads de dados.

Os valores aceitos são:

  • media: upload simples. Faça upload apenas da mídia, sem metadados.
  • multipart: upload de várias partes. Faça upload da mídia e dos metadados dela em uma única solicitação.
  • resumable: upload retomável. Faz upload do arquivo de modo retomável usando uma série de pelo menos duas solicitações em que a primeira inclui os metadados.
convert

boolean

Define se o arquivo será convertido para o formato correspondente dos Editores de arquivos Google.

enforceSingleParent
(deprecated)

boolean

Obsoleto: não há mais suporte para a criação de arquivos em várias pastas.

ocr

boolean

Para tentar usar o OCR nos uploads de .jpg, .png, .gif ou .pdf.

ocrLanguage

string

Se o parâmetro ocr for "true", ele indica o idioma a ser usado. Os valores válidos são códigos BCP 47.

pinned

boolean

Define se a revisão principal do arquivo enviado por upload será fixada. Um arquivo pode ter no máximo 200 revisões fixadas.

supportsAllDrives

boolean

Se o aplicativo que fez a solicitação é compatível com o Meu Drive e os drives compartilhados.

supportsTeamDrives
(deprecated)

boolean

Obsoleto: use supportsAllDrives.

timedTextLanguage

string

O idioma do texto com marcação de tempo.

timedTextTrackName

string

O nome da faixa de texto com marcação de tempo.

useContentAsIndexableText

boolean

Define se o conteúdo será usado como texto indexável.

visibility

enum (Visibility)

A visibilidade do novo arquivo. Esse parâmetro só é relevante quando convert=false.

includePermissionsForView

string

Especifica as permissões de visualização extra que vão ser incluídas na resposta. Somente published é aceito.

includeLabels

string

Uma lista separada por vírgulas de IDs de rótulos a serem incluídos na parte de labelInfo da resposta.

Corpo da solicitação

O corpo da solicitação contém uma instância de File.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de File.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.apps.readonly
  • https://www.googleapis.com/auth/drive.file

Alguns escopos são restritos e exigem uma avaliação de segurança para que sejam usados pelo app. Para mais informações, consulte o Guia de autorização.