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 de mídia MIME 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 como fazer upload de arquivos, consulte Fazer upload de dados de arquivos.

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 somente leitura fileExtension preenchida com a extensão originalmente especificada na propriedade title. Quando um usuário do Google Drive solicita o download de um arquivo ou quando o arquivo é baixado 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
convert

boolean

Se o arquivo será convertido para o formato correspondente dos Editores de arquivos Google.
enforceSingleParent
(deprecated)

boolean

Descontinuado: não é mais possível criar arquivos em várias pastas.
ocr

boolean

Se é necessário tentar o OCR em uploads de arquivos .jpg, .png, .gif ou .pdf.
ocrLanguage

string

Se "ocr" for verdadeiro, 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 será fixada. Um arquivo pode ter no máximo 200 revisões fixadas.
supportsAllDrives

boolean

Se o aplicativo solicitante é compatível com o Meu Drive e os drives compartilhados.
supportsTeamDrives
(deprecated)

boolean

Descontinuado: 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.
uploadType

string

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

Os valores aceitáveis são:

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

boolean

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

enum (Visibility)

A visibilidade do novo arquivo. As permissões ainda são herdadas das pastas principais. Esse parâmetro só é relevante quando convert=false.
includePermissionsForView

string

Especifica quais permissões de visualização adicionais incluir na resposta. Somente published é aceito.
includeLabels

string

Uma lista separada por vírgulas de IDs de rótulos a serem incluídos na parte 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 do 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 o app possa usá-los. Para mais informações, consulte o guia de autorização.